Funzione NtQueryInformationEnlistment (wdm.h)

Articolo
07.02.2025

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

Sintassi

C++

__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 ENLISTMENT_INFORMATION_CLASStipizzato che specifica le informazioni da ottenere. Questo valore deve essere uno dei valori seguenti:

EnlistmentBasicInformation
EnlistmentRecoveryInformation

Il valore di 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 di EnlistmentInformationClass parametro non è valido.
STATUS_INFO_LENGTH_MISMATCH	Il valore del EnlistmentInformationLength parametro non è valido.
STATUS_ACCESS_DENIED	Il chiamante non dispone dell'accesso appropriato all'oggetto di integrazione.

La routine potrebbe restituire altri valori NTSTATUS .

Osservazioni

Un gestore di risorse può chiamare ZwSetInformationEnlistment per impostare le informazioni di ripristino 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 NtXxx e ZwXxx versioni di una routine di Windows Native System Services 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.

Fabbisogno

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