ResUtilGetBinaryProperty-Funktion (resapi.h)

Ruft eine binäre Eigenschaft aus einer Eigenschaftenliste ab und führt einen Zeiger auf die nächste Eigenschaft in der Liste aus. Der PRESUTIL_GET_BINARY_PROPERTY Typ definiert einen Zeiger auf diese Funktion.

Syntax

DWORD ResUtilGetBinaryProperty(
  [out]          LPBYTE                 *ppbOutValue,
  [out]          LPDWORD                pcbOutValueSize,
  [in]           const PCLUSPROP_BINARY pValueStruct,
  [in, optional] const LPBYTE           pbOldValue,
  [in]           DWORD                  cbOldValueSize,
  [in, out]      LPBYTE                 *ppPropertyList,
  [in, out]      LPDWORD                pcbPropertyListSize
);

Parameter

[out] ppbOutValue

Adresse eines Zeigers, in dem der Binärwert aus der Eigenschaftenliste zurückgegeben wird.

[out] pcbOutValueSize

Zeiger auf die Größe des Ausgabewerts.

[in] pValueStruct

Zeiger auf eine CLUSPROP_BINARY Struktur, die den binärwert angibt, der aus der Eigenschaftenliste abgerufen werden soll.

[in, optional] pbOldValue

Zeiger auf den vorherigen Wert der Eigenschaft.

[in] cbOldValueSize

Zeiger auf die Länge des vorherigen Werts der Eigenschaft.

[in, out] ppPropertyList

Adresse des Zeigers auf den Eigenschaftenlistenpuffer, der die binäre Eigenschaft enthält. Dieser Zeiger wird bis zum Anfang der nächsten Eigenschaft erweitert.

[in, out] pcbPropertyListSize

Zeiger auf die Größe des Eigenschaftenlistenpuffers. Die Größe wird verringert, um den Fortschritt des ppPropertyList-Zeigers zu berücksichtigen.

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 ist ein möglicher Fehlercode aufgeführt.

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Die Daten sind falsch formatiert.

Anforderungen

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

Weitere Informationen

ResUtilGetDwordProperty

ResUtilGetMultiSzProperty

ResUtilGetSzProperty