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