Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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