ClusterRegQueryValue-Funktion (clusapi.h)
Gibt den Namen, den Typ und die Datenkomponenten zurück, die einem Wert für einen offenen Clusterdatenbankschlüssel zugeordnet sind.
Syntax
LONG ClusterRegQueryValue(
[in] HKEY hKey,
[in] LPCWSTR lpszValueName,
[out, optional] LPDWORD lpdwValueType,
[out, optional] LPBYTE lpData,
[in, out, optional] LPDWORD lpcbData
);
Parameter
[in] hKey
Handle des abzufragenden Clusterdatenbankschlüssels.
[in] lpszValueName
Zeiger auf eine mit NULL endende Unicode-Zeichenfolge, die den Namen des abzufragten Werts enthält.
[out, optional] lpdwValueType
Zeiger auf den Werttyp des Schlüssels. Dieser Parameter kann NULL sein, wenn der Typ nicht erforderlich ist. Andernfalls ist der über diesen Parameter zurückgegebene Wert einer der folgenden Werte.
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.
[out, optional] lpData
Zeiger auf die Daten des Werts. Dieser Parameter kann NULL sein, wenn die Daten nicht erforderlich sind.
[in, out, optional] lpcbData
Zeigen Sie bei der Eingabe auf die Anzahl der Bytes im Puffer, auf die der lpbData-Parameter verweist. Zeigen Sie in der Ausgabe auf die Anzahl der Bytes in den Daten des Werts, die im Inhalt von lpbData platziert wird, wenn der Aufrufer einen gültigen Zeiger übergibt.
Der lpbData-Parameter kann nur NULL sein, wenn lpbData ebenfalls NULL ist.
Rückgabewert
Die Funktion gibt einen der folgenden Werte zurück.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Der Puffer, auf den lpbData verweist, ist nicht groß genug, um die Daten für den Wert zu enthalten. ClusterRegQueryValue speichert die erforderliche Größe im Inhalt von lpbData. |
Hinweise
Wenn lpbDataNULL ist, gibt die ClusterRegQueryValue-FunktionERROR_SUCCESS zurück und speichert die Größe der Daten des Werts im Inhalt von lpbData. Diese Informationen ermöglichen es dem Aufrufer, einen Puffer für die Daten ordnungsgemäß zuzuordnen.
Wenn lpdwValueType auf REG_SZ, REG_MULTI_SZ oder REG_EXPAND_SZ festgelegt ist, enthält lpbData auch einen NULL-Abschlussator .
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 | clusapi.h |
| Bibliothek | ClusAPI.lib |
| DLL | ClusAPI.dll |