NtQueryInformationResourceManager-Funktion (wdm.h)

Artikel
03/05/2024

Die ZwQueryInformationResourceManager-Routine ruft Informationen zu einem angegebenen Ressourcen-Manager-Objekt ab.

Syntax

__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryInformationResourceManager(
  [in]            HANDLE                            ResourceManagerHandle,
  [in]            RESOURCEMANAGER_INFORMATION_CLASS ResourceManagerInformationClass,
  [out]           PVOID                             ResourceManagerInformation,
  [in]            ULONG                             ResourceManagerInformationLength,
  [out, optional] PULONG                            ReturnLength
);

Parameter

[in] ResourceManagerHandle

Ein Handle für ein Ressourcen-Manager-Objekt, das durch einen vorherigen Aufruf von ZwCreateResourceManager oder ZwOpenResourceManager abgerufen wurde. Das Handle muss RESOURCEMANAGER_QUERY_INFORMATION Zugriff auf das Objekt haben.

[in] ResourceManagerInformationClass

Ein RESOURCEMANAGER_INFORMATION_CLASS typisierter Wert, der die abzurufenden Informationen angibt. Dieser Wert muss ResourceManagerBasicInformation sein.

[out] ResourceManagerInformation

Ein Zeiger auf eine vom Aufrufer zugewiesene RESOURCEMANAGER_BASIC_INFORMATION-Struktur , die Informationen von ZwQueryInformationResourceManager empfängt.

[in] ResourceManagerInformationLength

Die Länge des Puffers in Bytes, auf den der ResourceManagerInformation-Parameter verweist.

[out, optional] ReturnLength

Ein Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Länge (in Bytes) der Informationen empfängt, die KTM in den ResourceManagerInformation-Puffer schreibt. Dieser Parameter ist optional und kann NULL sein.

Rückgabewert

ZwQueryInformationResourceManager gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Routine möglicherweise einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_OBJECT_TYPE_MISMATCH	Das angegebene Handle ist kein Handle für ein Resource Manager-Objekt.
STATUS_INVALID_HANDLE	Ein Objekthandle ist ungültig.
STATUS_INVALID_INFO_CLASS	Der Wert des ResourceManagerInformationClass-Parameters ist ungültig.
STATUS_BUFFER_TOO_SMALL	Die Puffergröße, die der ResourceManagerInformationLength-Parameter angibt, ist kleiner als die RESOURCEMANAGER_BASIC_INFORMATION-Struktur.
STATUS_BUFFER_OVERFLOW	Die vom ResourceManagerInformationLength-Parameter angegebene Puffergröße ist zu klein, um alle verfügbaren Informationen mit variabler Länge zu empfangen.
STATUS_ACCESS_DENIED	Der Aufrufer hat keinen entsprechenden Zugriff auf das Resource Manager-Objekt.

Die Routine gibt möglicherweise andere NTSTATUS-Werte zurück.

Hinweise

Weitere Informationen zur ZwQueryInformationResourceManager-Routine finden Sie unter Erstellen einer Resource Manager.

NtQueryInformationResourceManager und ZwQueryInformationResourceManager sind zwei Versionen derselben Windows Native System Services-Routine.

Bei Aufrufen von Kernelmodustreibern können sich die NtXxx - und ZwXxx-Versionen einer Windows Native System Services-Routine anders verhalten, da sie Eingabeparameter verarbeiten und interpretieren. Weitere Informationen zur Beziehung zwischen den Nt Xxx- und ZwXxx-Versionen einer Routine finden Sie unter Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Betriebssystemversionen.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs, PowerIrpDDis