ClusterRegSetValue-Funktion (clusapi.h)
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 |