Funzione NtQueryInformationEnlistment (wdm.h)

Articolo
08/08/2023

La routine ZwQueryInformationEnlistment recupera informazioni su un oggetto di integrazione specificato.

Sintassi

__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryInformationEnlistment(
  [in]            HANDLE                       EnlistmentHandle,
  [in]            ENLISTMENT_INFORMATION_CLASS EnlistmentInformationClass,
  [out]           PVOID                        EnlistmentInformation,
  [in]            ULONG                        EnlistmentInformationLength,
  [out, optional] PULONG                       ReturnLength
);

Parametri

[in] EnlistmentHandle

Handle per un oggetto di integrazione ottenuto da una chiamata precedente a ZwCreateEnlistment o ZwOpenEnlistment. L'handle deve avere ENLISTMENT_QUERY_INFORMATION accesso all'oggetto .

[in] EnlistmentInformationClass

Valore di enumerazione tipizzato ENLISTMENT_INFORMATION_CLASS che specifica le informazioni da ottenere. Questo valore deve essere uno dei valori seguenti:

EnlistmentBasicInformation
EnlistmentRecoveryInformation

Il valore EnlistmentFullInformation dell'enumerazione non viene usato con ZwQueryInformationEnlistment.

[out] EnlistmentInformation

Puntatore a un buffer allocato dal chiamante che riceve le informazioni specificate dal parametro EnlistmentInformationClass . Se il valore del parametro EnlistmentInformationClass è EnlistmentBasicInformation, il tipo di struttura del buffer deve essere ENLISTMENT_BASIC_INFORMATION. Se il valore del parametro EnlistmentInformationClass è EnlistmentRecoveryInformation, il tipo del buffer deve corrispondere al tipo definito dal chiamante usato dal chiamante quando viene chiamato ZwSetInformationEnlistment.

[in] EnlistmentInformationLength

Lunghezza, in byte, del buffer a cui punta il parametro EnlistmentInformation .

[out, optional] ReturnLength

Puntatore a una variabile allocata dal chiamante che riceve la lunghezza, in byte, delle informazioni che KTM scrive nel buffer EnlistmentInformation . Questo parametro è facoltativo e può essere NULL.

Valore restituito

ZwQueryInformationEnlistment restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa routine potrebbe restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_OBJECT_TYPE_MISMATCH	L'handle specificato non è un handle per un oggetto di integrazione.
STATUS_INVALID_HANDLE	L'handle dell'oggetto non è valido.
STATUS_INVALID_INFO_CLASS	Il valore del parametro EnlistmentInformationClass non è valido.
STATUS_INFO_LENGTH_MISMATCH	Il valore del parametro EnlistmentInformationLength non è valido.
STATUS_ACCESS_DENIED	Il chiamante non dispone dell'accesso appropriato all'oggetto di integrazione.

La routine potrebbe restituire altri valori NTSTATUS.

Commenti

Un gestore di risorse può chiamare ZwSetInformationEnlistment per impostare le informazioni di recupero specifiche dell'integrazione per un oggetto di integrazione e quindi chiamare ZwQueryInformationEnlistment per recuperare le informazioni di ripristino.

Per altre informazioni su ZwQueryInformationEnlistment, vedere Gestione delle operazioni di ripristino.

I chiamanti di ZwQueryInformationEnlistment devono essere in esecuzione in IRQL = PASSIVE_LEVEL.

NtQueryInformationEnlistment e ZwQueryInformationEnlistment sono due versioni della stessa routine di Servizi di sistema nativi di Windows.

Per le chiamate da driver in modalità kernel, le versioni NtXxx e ZwXxx di una routine di Servizi di sistema nativi di Windows possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Using Nt and Zw Versions of the Native System Services Routines .For more information about the Nt Xxx and Zw versions of the Native System Services Routines.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive del sistema operativo.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	HwStorPortProhibitedDDIs, PowerIrpDDis