注意:这是Microsoft Windows的将来版本中将支持的技术的初步文档。
LSRelease功能请求许可证系统发布与由【LicenseHandle】参数标识的许可证上下文相关联的许可资源。
LS_STATUS_CODE LS_API_ENTRY LSRelease(
LS_HANDLE 【LicenseHandle】, | //处理许可上下文 |
LS_ULONG 【TotUnitsConsumed】, | //在这个句柄上下文中消耗的单位 |
LS_STR 【*LogComment】 | //指向与请求相关联的可选注释的指针 |
); |
参数
【LicenseHandle】
[in]指定许可上下文的句柄。此参数必须是使用LSRequest 功能创建的句柄。
【TotUnitsConsumed】
[in]指定自LSRequest函数的初始调用以来,此句柄上下文中消耗的单位总数。您可以在应用程序中指定此许可证策略属性。LS_DEFAULT_UNITS的值表示许可证系统应使用自己的许可证策略机制来确定适当的值。
【LogComment】
[in]指向可选字符串,指示与请求相关联的注释。如果支持并启用日志记录,许可证系统可以记录注释。如果返回错误,许可证系统可以记录错误和注释,但不能保证。如果不指定字符串,则该值必须为LS_NULL。
返回值
如果函数成功,返回值为LS_SUCCESS。
如果函数失败,则返回值为状态码。有关扩展错误信息,请调用LSGetMessage 以返回与状态【码】相对应的状态【文本】.LSGetMessage功能可能会返回以下状态代码之一:
值 | 含义 |
LS_BAD_HANDLE | 呼叫中使用的句柄没有描述有效的许可证系统上下文。 |
LS_INSUFFICIENT_UNITS | 许可证系统无法找到足够的可用许可资源来完成请求。 |
LS_NETWORK_UNAVAILABLE | 网络不可用 |
LS_BAD_ARG | 一个或多个参数是不正确的。 |
备注
使用LSRelease功能来发布与由【LicenseHandle】参数标识的许可证上下文相关联的许可资源。如果消费许可证的策略生效,并且如果您选择在应用程序中实施这样的许可证策略,那么可以在【TotUnitsConsumed】参数中传递要使用的许可证单元。
LSRelease功能【不】释放许可证句柄上下文。请参阅LSFreeHandle的参考主题。
也可以看看