RegQueryInfoKeyA-Funktion (winreg.h)

Artikel
08/27/2023

Ruft Informationen zum angegebenen Registrierungsschlüssel ab.

Syntax

LSTATUS RegQueryInfoKeyA(
  [in]                HKEY      hKey,
  [out, optional]     LPSTR     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 für einen geöffneten Registrierungsschlüssel. Der Schlüssel muss mit dem zugriffsrecht KEY_QUERY_VALUE geöffnet worden sein. Weitere Informationen finden Sie unter Sicherheit und Zugriffsrechte für Registrierungsschlüssel.

Dieses Handle wird von der RegCreateKeyEx-, RegCreateKeyTransacted-, RegOpenKeyEx- oder RegOpenKeyTransacted-Funktion zurückgegeben. Es kann auch einer der folgenden vordefinierten Schlüssel sein:


   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, die 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ückgibt, enthält diese Variable die Größe der Klassenzeichenfolge, die im Puffer gespeichert ist. Die zurückgegebene Anzahl enthält nicht das beendende NULL-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 lpClass-Parameter eine gültige Adresse ist, der lpcClass-Parameter jedoch nicht, z. B. NULL, 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 von Unterschlüsseln 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 ANSI-Zeichen ohne das beendende NULL-Zeichen empfängt. 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 ANSI-Zeichen angibt. Die zurückgegebene Anzahl enthält nicht das beendende NULL-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 ANSI-Zeichen empfängt. Die Größe enthält nicht das beendende NULL-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 Bytes empfängt. Dieser Parameter kann NULL sein.

[out, optional] lpcbSecurityDescriptor

Ein Zeiger auf eine Variable, die die Größe der Sicherheitsbeschreibung des Schlüssels in Bytes 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 Member der FILETIME-Struktur so fest, dass sie den Zeitpunkt angeben, zu dem der Schlüssel oder ein beliebiger seiner Werteinträge 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 empfangen, gibt die Funktion ERROR_MORE_DATA zurück.

Hinweise

Hinweis

In Legacyversionen von Windows wird diese API auch von kernel32.dll verfügbar gemacht.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winreg.h (einschließlich Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll