共用方式為

SLQueryLicenseValueFromApp 函式 (slpublic.h)

  • 發行項

[此 API 不適用於所有 Windows/Windows Phone 應用程式。 除非您的開發人員帳戶是由 Microsoft 特別布建，否則呼叫這些 API 會在運行時間失敗。

取得指定元件原則的值。

語法

HRESULT SLQueryLicenseValueFromApp(
  [in]            PCWSTR valueName,
  [out, optional] ULONG  *valueType,
  [out, optional] PVOID  dataBuffer,
  [in]            ULONG  dataSize,
  [out]           ULONG  *resultDataSize
);

參數

[in] valueName

您要取得資訊的原則名稱。

[out, optional] valueType

原則值的數據類型。 下表描述此參數可接收的值。

值 Description
REG_DWORD 32 位元的整數。 針對此類型， dataBuffer 參數指定的緩衝區大小至少應為 4 個字節。
REG_BINARY 二進位值。
REG_SZ 寬字元、以 Null 結尾的字串，包括最後一個 Null 字元。

[out, optional] dataBuffer

接收元件原則值的緩衝區。

[in] dataSize

所提供緩衝區的大小，以位元組為單位。

[out] resultDataSize

針對原則值所接收之數據的實際大小，以位元組為單位。

傳回值

如果此函式成功，它會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

值 意義
E_INVALIDARG
0x80070057
 一或多個自變數無效。
SL_E_VALUE_NOT_FOUND
0xC004F012
 找不到指定的名稱/值組。

備註

您的應用程式必須具有受限制的 slapiQueryLicenseValue 功能，才能呼叫 SLQueryLicenseValueFromApp 函式。

規格需求

需求 值
最低支援的用戶端 Windows 10 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2016 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 slpublic.h
程式庫 Api-ms-win-core-slapi-l1-1-0.lib
Dll Api-ms-win-core-slapi-l1-1-0.dll