ORQueryInfoKey-Funktion

Ruft Informationen zum angegebenen Registrierungsschlüssel in einer Offlineregistrierungsstruktur ab.

Syntax

DWORD ORQueryInfoKey(
  _In_        ORHKEY    Handle,
  _Out_opt_   PWSTR     lpClass,
  _Inout_opt_ PDWORD    lpcClass,
  _Out_opt_   PDWORD    lpcSubKeys,
  _Out_opt_   PDWORD    lpcMaxSubKeyLen,
  _Out_opt_   PDWORD    lpcMaxClassLen,
  _Out_opt_   PDWORD    lpcValues,
  _Out_opt_   PDWORD    lpcMaxValueNameLen,
  _Out_opt_   PDWORD    lpcMaxValueLen,
  _Out_opt_   PDWORD    lpcbSecurityDescriptor,
  _Out_opt_   PFILETIME lpftLastWriteTime
);

Parameter

Handle [ In]

Ein Handle für einen geöffneten Registrierungsschlüssel in einer Offlineregistrierungsstruktur.

lpClass [ out, optional]

Ein Zeiger auf einen Puffer, der die Schlüsselklasse empfängt. Dieser Parameter kann NULL sein.

lpcClass [ in, out, optional]

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

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 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 lpClass NULL ist, kann lpcClass NULL sein.

Wenn der lpClass-Parameter eine gültige Adresse ist, der lpcClass-Parameter jedoch nicht (z. B. wenn der lpcClass-Parameter NULL ist), gibt die Funktion ERROR _ INVALID PARAMETER _ zurück.

lpcSubKeys [ out, optional]

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.

lpcMaxSubKeyLen [ out, optional]

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, ohne das beendende NULL-Zeichen. Dieser Parameter kann NULL sein.

lpcMaxClassLen [ out, optional]

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 NULL-Zeichen. Dieser Parameter kann NULL sein.

lpcValues [ out, optional]

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

lpcMaxValueNameLen [ out, optional]

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

lpcMaxValueLen [ out, optional]

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

lpcbSecurityDescriptor [ out, optional]

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

lpftLastWriteTime [ out, optional]

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 fest, um anzugeben, zu welchem Zeitpunkt der Schlüssel oder seine Werteinträge zuletzt geändert werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ERROR _ SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein fehlerfreier Code, der in Winerror.h definiert ist. Sie können die FormatMessage-Funktion mit dem Flag FORMAT _ MESSAGE FROM SYSTEM _ _ verwenden, um eine generische Beschreibung des Fehlers zu erhalten.

Wenn der lpClass-Puffer zu klein ist, um den Namen der Klasse zu erhalten, gibt die Funktion ERROR _ MORE DATA _ zurück.

Anforderungen

Anforderung Wert
Verteilbare Komponente
Windows Offlineregistrierungsbibliothek, Version 1.0 oder höher
Header
Offreg.h
DLL
Offreg.dll

Siehe auch

FILETIME

ORCreateKey

OROpenKey

ORDeleteKey