LSGetMessage

【勇芳软件工作室】汉化HomePreviousNext

注意:这是Microsoft Windows的将来版本中将支持的技术的初步文档。

LSGetMessage函数返回与许可证服务功能状态代码相关联的消息字符串。

LS_STATUS_CODE LS_API_ENTRY LSGetMessage(

LS_HANDLE 【LicenseHandle】,//处理许可上下文
LS_STATUS_CODE 【值】,//许可证服务功能返回的任何状态代码
LS_STR 【*缓冲】,//指向缓冲区的指针返回错误消息字符串
LS_ULONG 【BufferSize】//缓冲区字符串的最大大小
); 

参数

【LicenseHandle】

[in]指定许可上下文的句柄。该参数必须是使用LSRequest 功能创建的句柄。

【值】

[in]指定许可证服务功能返回的任何状态代码。

【缓冲】

[out]指向将返回本地化错误消息字符串的缓冲区。

【BufferSize】

[in]以字节表示【缓冲】参数中返回的字符串的最大大小。

返回值

如果函数成功,返回值为LS_SUCCESS。

如果函数失败,则返回值为状态码。有关扩展错误信息,请调用LSGetMessage返回与状态【码】相对应的状态【文本】.LSGetMessage功能可能会返回以下状态代码之一:

含义
LS_BAD_HANDLE呼叫中使用的句柄没有描述有效的许可证系统上下文。
LS_RESOURCES_UNAVAILABLE由于资源不足(如内存),请求无法完成。
LS_TEXT_UNAVAILABLE使用LSGetMessage功能查找错误消息字符串时发生警告。
LS_UNKNOWN_STATUS无法识别的状态代码已传递给LSGetMessage功能。
LS_BUFFER_TOO_SMALL【缓冲】参数指向的缓冲区太小,无法容纳要返回的文本字符串;或挑战数据结构太小而不能应对挑战响应。
LS_BAD_ARG一个或多个参数是不正确的。

备注

LSGetMessage函数返回一个描述特定错误的字符串,并可能需要采取一个建议的操作来响应它。如果【值】参数【】中指定的值为常量LS_USE_LAST,则返回与提供的许可手柄相关联的最后一个错误及其相关数据。否则,该函数使用提供的错误代码。

也可以看看

LSRequest