ClusterRegQueryValue-Funktion (clusapi.h)

Artikel
02/28/2024

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
ERROR_SUCCESS 0 (0x0)	Der Vorgang wurde durchgeführt.
ERROR_MORE_DATA 234 (0xEA)	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

Weitere Informationen

ClusterRegOpenKey

Freigeben über