ResUtilGetBinaryValue-Funktion (resapi.h)

Gibt einen Binärwert aus der Clusterdatenbank zurück.

Syntax

DWORD ResUtilGetBinaryValue(
  [in]            HKEY    hkeyClusterKey,
  [in]            LPCWSTR pszValueName,
  [out, optional] LPBYTE  *ppbOutValue,
  [out]           LPDWORD pcbOutValueSize
);

Parameter

[in] hkeyClusterKey

Schlüssel in der Clusterdatenbank, der den Speicherort des abzurufenden Werts identifiziert.

[in] pszValueName

Zeiger auf eine mit NULL beendete Unicode-Zeichenfolge, die den Namen des abzurufenden Werts enthält.

[out, optional] ppbOutValue

Adresse des Zeigers auf den abgerufenen Wert.

[out] pcbOutValueSize

Zeiger auf ein DWORD , in dem die Größe des Puffers in Bytes zurückgegeben wird, auf den ppbOutValue verweist.

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_NOT_ENOUGH_MEMORY	Fehler bei der Zuweisung von Arbeitsspeicher für den Wert.

Hinweise

Die ResUtilGetBinaryValue-Hilfsprogrammfunktion übernimmt die Zuweisung des erforderlichen Arbeitsspeichers für den Wert und ruft dann die Cluster-API-FunktionClusterRegQueryValue auf. Wenn Sie mit dem zugewiesenen Arbeitsspeicher fertig sind, müssen Sie die Funktion LocalFree aufrufen, um ihn freizugeben.

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

Weitere Informationen

ClusterRegQueryValue

ResUtilGetDwordValue

ResUtilGetExpandSzValue

ResUtilGetMultiSzValue

ResUtilGetSzValue