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 |
|
| DLL |
|