共用方式為

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*

應用程式識別碼的指標。

[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 寬限的 VL 用戶端 KMS 要求數目。
SL_INFO_KEY_KMS_OOT_GRACE_REQUESTS
L“KeyManagementServiceOOTGraceRequests”
 具有授權狀態=OOT 寬限的 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 錯誤碼。

傳回碼/值 Description
E_INVALIDARG
0x80070057
 一或多個自變數無效。
SL_E_VALUE_NOT_FOUND
0xC004F012
 找不到輸入索引鍵的值。

規格需求

需求 值
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 slpublic.h
程式庫 Slc.lib
Dll Slc.dll