RegQueryInfoKeyW-Funktion (winreg.h)

Ruft Informationen zum angegebenen Registrierungsschlüssel ab.

Syntax

LSTATUS RegQueryInfoKeyW(
  [in]                HKEY      hKey,
  [out, optional]     LPWSTR    lpClass,
  [in, out, optional] LPDWORD   lpcchClass,
                      LPDWORD   lpReserved,
  [out, optional]     LPDWORD   lpcSubKeys,
  [out, optional]     LPDWORD   lpcbMaxSubKeyLen,
  [out, optional]     LPDWORD   lpcbMaxClassLen,
  [out, optional]     LPDWORD   lpcValues,
  [out, optional]     LPDWORD   lpcbMaxValueNameLen,
  [out, optional]     LPDWORD   lpcbMaxValueLen,
  [out, optional]     LPDWORD   lpcbSecurityDescriptor,
  [out, optional]     PFILETIME lpftLastWriteTime
);

Parameter

[in] hKey

Ein Handle zu einem geöffneten Registrierungsschlüssel. Der Schlüssel muss mit dem zugriffsrecht KEY_QUERY_VALUE geöffnet worden sein. Weitere Informationen finden Sie unter Registry Key Security and Access Rights.

Dieses Handle wird von der RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyExoder RegOpenKeyTransacted Funktion zurückgegeben. Es kann auch einer der folgenden vordefinierten Schlüsselsein:

   HKEY_CLASSES_ROOT
   HKEY_CURRENT_CONFIG
   HKEY_CURRENT_USER
   HKEY_LOCAL_MACHINE
   HKEY_PERFORMANCE_DATA
   HKEY_USERS

[out, optional] lpClass

Ein Zeiger auf einen Puffer, der die benutzerdefinierte Klasse des Schlüssels empfängt. Dieser Parameter kann NULL-sein.

[in, out, optional] lpcchClass

Ein Zeiger auf eine Variable, der die Größe des Puffers angibt, auf den der lpClass-Parameter in Zeichen verweist.

Die Größe sollte das beendende null Zeichen enthalten. Wenn die Funktion zurückgegeben wird, enthält diese Variable die Größe der Klassenzeichenfolge, die im Puffer gespeichert ist. Die zurückgegebene Anzahl enthält nicht das beendende Nullzeichen Zeichen. Wenn der Puffer nicht groß genug ist, gibt die Funktion ERROR_MORE_DATA zurück, und die Variable enthält die Größe der Zeichenfolge in Zeichen, ohne das beendende null Zeichen zu zählen.

Wenn lpClassNULL-ist, kann lpcClassNULL-sein.

Wenn der parameter lpClass eine gültige Adresse ist, aber der lpcClass Parameter nicht ist, ist er z. B. NULL-, dann gibt die Funktion ERROR_INVALID_PARAMETER zurück.

lpReserved

Dieser Parameter ist reserviert und muss NULL-sein.

[out, optional] lpcSubKeys

Ein Zeiger auf eine Variable, die die Anzahl der Unterschlüssel empfängt, die im angegebenen Schlüssel enthalten sind. Dieser Parameter kann NULL-sein.

[out, optional] lpcbMaxSubKeyLen

Ein Zeiger auf eine Variable, die die Größe des Unterschlüssels des Schlüssels mit dem längsten Namen in Unicode-Zeichen empfängt, nicht einschließlich des endenden Null- Zeichens. Dieser Parameter kann NULL-sein.

[out, optional] lpcbMaxClassLen

Ein Zeiger auf eine Variable, die die Größe der längsten Zeichenfolge empfängt, die eine Unterschlüsselklasse in Unicode-Zeichen angibt. Die zurückgegebene Anzahl enthält nicht das beendende Nullzeichen Zeichen. Dieser Parameter kann NULL-sein.

[out, optional] lpcValues

Ein Zeiger auf eine Variable, die die Anzahl der Werte empfängt, die dem Schlüssel zugeordnet sind. Dieser Parameter kann NULL-sein.

[out, optional] lpcbMaxValueNameLen

Ein Zeiger auf eine Variable, die die Größe des längsten Wertnamens des Schlüssels in Unicode-Zeichen empfängt. Die Größe enthält nicht das beendende Nullzeichen Zeichen. Dieser Parameter kann NULL-sein.

[out, optional] lpcbMaxValueLen

Ein Zeiger auf eine Variable, die die Größe der längsten Datenkomponente unter den Werten des Schlüssels in Byte empfängt. Dieser Parameter kann NULL-sein.

[out, optional] lpcbSecurityDescriptor

Ein Zeiger auf eine Variable, die die Größe des Sicherheitsdeskriptors des Schlüssels in Byte empfängt. Dieser Parameter kann NULL-sein.

[out, optional] lpftLastWriteTime

Ein Zeiger auf eine FILETIME- Struktur, die die letzte Schreibzeit empfängt. Dieser Parameter kann NULL-sein.

Die Funktion legt die Elemente der FILETIME Struktur fest, um anzugeben, dass der Schlüssel oder ein Werteintrag zuletzt geändert wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode.

Wenn der lpClass Puffer zu klein ist, um den Namen der Klasse zu erhalten, gibt die Funktion ERROR_MORE_DATA zurück.

Bemerkungen

Anforderungen

Siehe auch

FILETIME-

RegDeleteKey-

RegEnumKeyEx-

RegEnumValue-

RegQueryValueEx-

Registrierungsfunktionen

Registrierungsübersicht