注意:这是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,则返回与提供的许可手柄相关联的最后一个错误及其相关数据。否则,该函数使用提供的错误代码。
也可以看看