LSRelease

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

注意:这是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的参考主题。

也可以看看

LSFreeHandle,LSGetMessage,LSRequest