ResUtilFindLongProperty 函式 (resapi.h)

發行項
03/05/2024

在屬性清單中找出帶正負號的long屬性值。 PRESUTIL_FIND_LONG_PROPERTY類型會定義此函式的指標。

語法

DWORD ResUtilFindLongProperty(
  [in]  const PVOID pPropertyList,
  [in]  DWORD       cbPropertyListSize,
  [in]  LPCWSTR     pszPropertyName,
  [out] LPLONG      plPropertyValue
);

參數

[in] pPropertyList

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

[in] cbPropertyListSize

以位元組為單位的大小，包含 於 pPropertyList 中的數據。

[in] pszPropertyName

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

[out] plPropertyValue

屬性清單緩衝區中儲存之數據的實際值指標。

傳回值

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

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

傳回碼	Description
ERROR_INVALID_DATA	數據的格式不正確。
ERROR_FILE_NOT_FOUND	屬性無法位於屬性清單中。

備註

如果作業成功， plPropertyValue 會直接指向屬性列表緩衝區。使用 plPropertyValue 時，請小心不要干擾屬性清單的格式設定。

規格需求

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