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 |
|---|---|
|
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 |