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, 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 ist (z. B. wenn der lpcClass-ParameterNULL 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 enthält nicht das beendende NULL-Zeichen. Dieser Parameter kann NULL sein.
-
lpcMaxValueLen [out, optional]
-
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.
-
lpcbSecurityDescriptor [out, optional]
-
Ein Zeiger auf eine Variable, die die Größe der Sicherheitsbeschreibung 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 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 nichtzero-Fehlercode, 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 abzurufen.
Wenn der lpClass-Puffer zu klein ist, um den Namen der Klasse zu empfangen, gibt die Funktion ERROR_MORE_DATA zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Verteilbare Komponente |
Windows-Offlineregistrierungsbibliothek Version 1.0 oder höher |
| Header |
|
| DLL |
|
Siehe auch