ResUtilSetBinaryValue-Funktion (resapi.h)

Artikel
08/25/2023

Legt einen binärwert in der Clusterdatenbank fest.

Syntax

DWORD ResUtilSetBinaryValue(
  [in]                HKEY         hkeyClusterKey,
  [in]                LPCWSTR      pszValueName,
  [in]                const LPBYTE pbNewValue,
  [in]                DWORD        cbNewValueSize,
  [in, out, optional] LPBYTE       *ppbOutValue,
  [in, out]           LPDWORD      pcbOutValueSize
);

Parameter

[in] hkeyClusterKey

Schlüssel, der den Speicherort des Binärwerts in der Clusterdatenbank identifiziert.

[in] pszValueName

Eine mit NULL endende Unicode-Zeichenfolge, die den Namen des zu aktualisierenden Werts enthält.

[in] pbNewValue

Zeiger auf den neuen Binärwert.

[in] cbNewValueSize

Größe des neuen Binärwerts.

[in, out, optional] ppbOutValue

Adresse eines Zeigers auf den neuen Binärwert.

[in, out] pcbOutValueSize

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

Rückgabewert

Wenn der Vorgang erfolgreich ist, 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	Während der Speicherbelegung ist ein Fehler aufgetreten.

Hinweise

Die ResUtilSetBinaryValue-Hilfsprogrammfunktion ordnet arbeitsspeicher für den ppbOutValue-Zeiger mithilfe der Funktion LocalAlloc zu, ruft die Cluster-API-Funktion ClusterRegSetValue auf und kopiert dann den neuen Wert in diesen Puffer. Wenn der Zeiger nicht NULL ist, wird die Zuordnung durch ResUtilSetBinaryValue ebenfalls aufgehoben. Als Aufrufer dieser Funktion sind Sie für das Aufheben der Zuordnung des Puffers mit der Funktion LocalFree verantwortlich.

Rufen Sie ResUtilSetBinaryValue nicht über die folgenden Ressourcen-DLL-Einstiegspunktfunktionen auf:

ResUtilSetBinaryValue kann von jeder anderen Ressourcen-DLL-Einstiegspunktfunktion oder aus einem Workerthread sicher aufgerufen werden. Weitere Informationen finden Sie unter Zu vermeidende Funktionsaufrufe in Ressourcen-DLLs.

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

ClusterRegSetValue

ResUtilSetDwordValue

ResUtilSetExpandSzValue

ResUtilSetMultiSzValue

ResUtilSetSzValue

Freigeben über