SLGetApplicationInformation 函数 (slpublic.h)

  • 项目

获取有关指定应用程序的信息。

语法

HRESULT SLGetApplicationInformation(
  [in]            HSLC       hSLC,
  [in]            const SLID *pApplicationId,
  [in]            PCWSTR     pwszValueName,
  [out, optional] SLDATATYPE *peDataType,
  [out]           UINT       *pcbValue,
  [out]           PBYTE      *ppbValue
);

参数

[in] hSLC

类型： HSLC

当前 SLC 上下文的句柄。

[in] pApplicationId

类型： const SLID*

指向应用程序 ID 的指针。

[in] pwszValueName

类型： PCWSTR

值 含义
SL_INFO_KEY_IS_KMS
L“IsKeyManagementService”
 指示计算机是否启用了密钥管理服务 (KMS) 。
SL_INFO_KEY_KMS_CURRENT_COUNT
L“KeyManagementServiceCurrentCount”
 KMS 主机上当前处于活动状态的卷客户端数。
SL_INFO_KEY_KMS_REQUIRED_CLIENT_COUNT
L“KeyManagementServiceRequiredClientCount”
 连接到 KMS 主机以启用激活所需的最小 VL 客户端数。
SL_INFO_KEY_KMS_UNLICENSED_REQUESTS
L“KeyManagementServiceUnlicensedRequests”
 许可证状态为“未授权”的 VL 客户端发出的 KMS 请求数。
SL_INFO_KEY_KMS_LICENSED_REQUESTS
L“KeyManagementServiceLicensedRequests”
 许可证状态为“已许可”的 VL 客户端发出的 KMS 请求数。
SL_INFO_KEY_KMS_OOB_GRACE_REQUESTS
L“KeyManagementServiceOOBGraceRequests”
 来自许可证状态=OOB Grace 的 VL 客户端的 KMS 请求数。
SL_INFO_KEY_KMS_OOT_GRACE_REQUESTS
L“KeyManagementServiceOOTGraceRequests”
 来自许可证状态为 OOT Grace 的 VL 客户端的 KMS 请求数。
SL_INFO_KEY_KMS_NON_GENUINE_GRACE_REQUESTS
L“KeyManagementServiceNonGenuineGraceRequests”
 来自许可证状态为非正版宽限的 VL 客户端的 KMS 请求数。
SL_INFO_KEY_KMS_NOTIFICATION_REQUESTS
L“KeyManagementServiceNotificationRequests”
 来自许可证状态=通知的 VL 客户端的 KMS 请求数。
SL_INFO_KEY_KMS_TOTAL_REQUESTS
L“KeyManagementServiceTotalRequests”
 有效 KMS 请求的总数。
SL_INFO_KEY_KMS_FAILED_REQUESTS
L“KeyManagementServiceFailedRequests”
 失败的 KMS 请求总数。

[out, optional] peDataType

类型： SLDATATYPE*

指向 SLDATATYPE 枚举的值的指针，该值指定 ppbValue 缓冲区中的数据类型。 以下值有效。

值 含义
SL_DATA_SZ
 UNICODE 字符串
SL_DATA_DWORD
 DWORD
SL_DATA_BINARY
 二进制 Blob

[out] pcbValue

类型： UINT*

指向 ppbValue 缓冲区的大小（以字节为单位）的指针。

[out] ppbValue

类型： PBYTE*

如果成功，将在 SLC 分配的缓冲区中返回数据。
使用完内存后，通过调用 LocalFree 函数释放内存。

返回值

类型： HRESULT WINAPI

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

返回代码/值 说明
E_INVALIDARG
0x80070057
 一个或多个参数无效。
SL_E_VALUE_NOT_FOUND
0xC004F012
 找不到输入键的值。

要求

要求 值
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 slpublic.h
Library Slc.lib
DLL Slc.dll