Función NtQueryInformationEnlistment (wdm.h)
La rutina ZwQueryInformationEnlistment recupera información sobre un objeto de inscripción especificado.
Sintaxis
__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryInformationEnlistment(
[in] HANDLE EnlistmentHandle,
[in] ENLISTMENT_INFORMATION_CLASS EnlistmentInformationClass,
[out] PVOID EnlistmentInformation,
[in] ULONG EnlistmentInformationLength,
[out, optional] PULONG ReturnLength
);
Parámetros
[in] EnlistmentHandle
Identificador de un objeto de inscripción obtenido por una llamada anterior a ZwCreateEnlistment o ZwOpenEnlistment. El identificador debe tener ENLISTMENT_QUERY_INFORMATION acceso al objeto .
[in] EnlistmentInformationClass
Valor de enumeración con tipo ENLISTMENT_INFORMATION_CLASS que especifica la información que se va a obtener. Este valor debe ser uno de los siguientes valores:
- InscripciónBasicInformation
- EnlistmentRecoveryInformation
[out] EnlistmentInformation
Puntero a un búfer asignado por el autor de la llamada que recibe la información que especifica el parámetro EnlistmentInformationClass . Si el valor del parámetro EnlistmentInformationClass es EnlistmentBasicInformation, el tipo de estructura de este búfer debe ser ENLISTMENT_BASIC_INFORMATION. Si el valor del parámetro EnlistmentInformationClass es EnlistmentRecoveryInformation, el tipo de este búfer debe coincidir con el tipo definido por el llamador que usó el autor de la llamada cuando llamó a ZwSetInformationEnlistment.
[in] EnlistmentInformationLength
Longitud, en bytes, del búfer al que apunta el parámetro EnlistmentInformation .
[out, optional] ReturnLength
Puntero a una variable asignada por el autor de la llamada que recibe la longitud, en bytes, de la información que KTM escribe en el búfer EnlistmentInformation . Este parámetro es opcional y puede ser NULL.
Valor devuelto
ZwQueryInformationEnlistment devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta rutina podría devolver uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
|
El identificador especificado no es un identificador para un objeto de inscripción. |
|
El identificador de objeto no es válido. |
|
El valor del parámetro EnlistmentInformationClass no es válido. |
|
El valor del parámetro EnlistmentInformationLength no es válido. |
|
El autor de la llamada no tiene el acceso adecuado al objeto de inscripción. |
La rutina podría devolver otros valores NTSTATUS.
Comentarios
Un administrador de recursos puede llamar a ZwSetInformationEnlistment para establecer información de recuperación específica de la inscripción para un objeto de inscripción y, a continuación, llamar a ZwQueryInformationEnlistment para recuperar la información de recuperación.
Para obtener más información sobre ZwQueryInformationEnlistment, consulte Control de operaciones de recuperación.
Los autores de llamadas de ZwQueryInformationEnlistment deben ejecutarse en IRQL = PASSIVE_LEVEL.
NtQueryInformationEnlistment y ZwQueryInformationEnlistment son dos versiones de la misma rutina de Windows Native System Services.
En el caso de las llamadas desde controladores en modo kernel, las versiones NtXxx y ZwXxx de una rutina de Windows Native System Services pueden comportarse de forma diferente en la forma en que controlan e interpretan los parámetros de entrada. Para obtener más información sobre la relación entre las versiones NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows Vista y versiones posteriores del sistema operativo. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | HwStorPortProhibitedDIs, PowerIrpDDis |
Consulte también
Uso de las versiones Nt y Zw de las rutinas nativas de System Services