resUtilFindBinaryProperty 函式 (resapi.h)

發行項
03/05/2024

在屬性清單中找出指定的二進位屬性，也可以傳回屬性的值。 PRESUTIL_FIND_BINARY_PROPERTY類型會定義此函式的指標。

語法

DWORD ResUtilFindBinaryProperty(
  [in]            const PVOID pPropertyList,
  [in]            DWORD       cbPropertyListSize,
  [in]            LPCWSTR     pszPropertyName,
  [out, optional] LPBYTE      *pbPropertyValue,
  [out, optional] LPDWORD     pcbPropertyValueSize
);

參數

[in] pPropertyList

要在其中尋找值的屬性清單指標。

[in] cbPropertyListSize

pPropertyList 所指定屬性清單的大小，以位元組為單位。

[in] pszPropertyName

Null 終止的 Unicode 字串指標，其中包含要尋找的屬性名稱。

[out, optional] pbPropertyValue

函式所配置之緩衝區 (的 BYTE 指標指標，) 包含屬性值複本。您必須在 *pbPropertyValue) 上呼叫 LocalFree (，以釋放配置的記憶體。如果不需要任何值，請傳遞此參數的 NULL 。

[out, optional] pcbPropertyValueSize

所傳回值的大小指標，以位元組為單位。如果不需要任何大小，請傳遞此參數的 NULL 。

傳回值

如果作業成功，函式會 傳回ERROR_SUCCESS。

如果作業失敗，函式會傳回系統錯誤碼。以下是可能的錯誤碼。

傳回碼	Description
ERROR_INVALID_DATA	屬性清單的格式不正確。
ERROR_NOT_ENOUGH_MEMORY	函式無法配置要傳回屬性值的緩衝區。
ERROR_FILE_NOT_FOUND	指定的屬性無法位於屬性清單中。

備註

如果 ResUtilFindBinaryProperty 成功，*pbPropertyValue 會指向 儲存在 pPropertyList 中的數據複本。請務必在 *pbPropertyValue 上呼叫 LocalFree 以防止記憶體流失。

規格需求

需求	值
最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
目標平台	Windows
標頭	resapi.h
程式庫	ResUtils.lib
Dll	ResUtils.dll