ResUtilFindBinaryProperty-Funktion (resapi.h)

Artikel
08/25/2023

Sucht eine angegebene binäre Eigenschaft in einer Eigenschaftenliste und kann auch den Wert der Eigenschaft zurückgeben. Der PRESUTIL_FIND_BINARY_PROPERTY Typ definiert einen Zeiger auf diese Funktion.

Syntax

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

Parameter

[in] pPropertyList

Zeiger auf die Eigenschaftenliste, in der der Wert gesucht werden soll.

[in] cbPropertyListSize

Größe der von pPropertyList angegebenen Eigenschaftenliste in Byte.

[in] pszPropertyName

Zeiger auf eine mit NULL endende Unicode-Zeichenfolge, die den Namen der zu suchenden Eigenschaft enthält.

[out, optional] pbPropertyValue

Zeiger auf einen BYTE-Zeiger auf einen Puffer (zugeordnet durch die Funktion), der eine Kopie des Eigenschaftswerts enthält. Sie müssen LocalFree (auf *pbPropertyValue) aufrufen, um den zugewiesenen Arbeitsspeicher freizugeben. Wenn kein Wert erforderlich ist, übergeben Sie NULL für diesen Parameter.

[out, optional] pcbPropertyValueSize

Zeiger auf die Größe des zurückgegebenen Werts in Bytes. Wenn keine Größe erforderlich ist, übergeben Sie NULL für diesen Parameter.

Rückgabewert

Wenn die Vorgänge erfolgreich sind, gibt die Funktion ERROR_SUCCESS zurück.

Wenn der Vorgang fehlschlägt, gibt die Funktion einen Systemfehlercode zurück. Im Folgenden finden Sie mögliche Fehlercodes.

Rückgabecode	Beschreibung
ERROR_INVALID_DATA	Die Eigenschaftenliste ist falsch formatiert.
ERROR_NOT_ENOUGH_MEMORY	Die Funktion konnte keinen Puffer zuordnen, in dem der Eigenschaftswert zurückgegeben werden soll.
ERROR_FILE_NOT_FOUND	Die angegebene Eigenschaft konnte nicht in der Eigenschaftenliste gefunden werden.

Hinweise

Wenn ResUtilFindBinaryProperty erfolgreich ist, verweist *pbPropertyValue auf eine Kopie der in pPropertyList gespeicherten Daten. Achten Sie darauf , LocalFree für *pbPropertyValue aufzurufen, um Speicherverluste zu verhindern.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Zielplattform	Windows
Kopfzeile	resapi.h
Bibliothek	ResUtils.lib
DLL	ResUtils.dll