Freigeben über

ClusterRegSetValue-Funktion (clusapi.h)

  • Artikel

Legt einen Wert für einen Clusterdatenbankschlüssel fest.

Syntax

DWORD ClusterRegSetValue(
  [in] HKEY       hKey,
  [in] LPCWSTR    lpszValueName,
  [in] DWORD      dwType,
  [in] const BYTE *lpData,
  [in] DWORD      cbData
);

Parameter

[in] hKey

Handle für einen Clusterdatenbankschlüssel.

[in] lpszValueName

Zeiger auf eine mit NULL endende Unicode-Zeichenfolge, die den Namen des festzulegenden Werts enthält. Wenn ein Wert mit diesem Namen noch nicht in der Ressource vorhanden ist, fügt ClusterRegSetValue ihn der Ressource hinzu.

[in] dwType

Typ der Informationen, die als Daten des Werts gespeichert werden sollen. Dieser Parameter kann einen der folgenden Werte annehmen. Weitere Informationen finden Sie unter Registrierungswerttypen.

REG_BINARY (3)

Binärdaten in beliebiger Form.

REG_DWORD (4)

Eine 32-Bit-Zahl.

REG_DWORD_BIG_ENDIAN (5)

Eine im Big-Endian-Format gespeicherte 32-Bit-Zahl.

REG_EXPAND_SZ (2)

Eine mit NULL endende Unicode-Zeichenfolge, die nicht aufgeklärte Verweise auf Umgebungsvariablen enthält (z. B. "%PATH%").

REG_MULTI_SZ (6)

Eine Sequenz von NULL-beendeten Zeichenfolgen, die durch eine leere Zeichenfolge (\0) beendet wird.

Es folgt ein Beispiel:

String1\0String2\0String3\0LastString\0\0

Die erste \0 beendet die erste Zeichenfolge, die zweite mit der letzten \0 die letzte Zeichenfolge, und die letzte \0 beendet die Sequenz. Beachten Sie, dass das endgültige Abschlusszeichen in die Länge der Zeichenfolge eingegliedert werden muss.

REG_NONE (0)

Kein definierter Werttyp.

REG_QWORD (11)

Eine 64-Bit-Zahl.

REG_SZ (1)

Eine null-terminierte Unicode-Zeichenfolge.

[in] lpData

Zeiger auf die zu speichernden Daten mit dem Namen, auf den lpszValueName verweist.

[in] cbData

Anzahl der Bytes in den Daten, auf die der lpbData-Parameter verweist. Wenn die Daten vom Typ REG_SZ, REG_EXPAND_SZ oder REG_MULTI_SZ sind, muss cbData die Größe des Nullabschlusszeichens enthalten.

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.

Hinweise

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

ClusterRegSetValue 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

   
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Zielplattform Windows
Kopfzeile clusapi.h
Bibliothek ClusAPI.lib
DLL ClusAPI.dll

Weitere Informationen

ClusterRegOpenKey

GetLastError