Compartir a través de


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
El valor EnlistmentFullInformation de la enumeración no se usa con ZwQueryInformationEnlistment.

[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
STATUS_OBJECT_TYPE_MISMATCH
El identificador especificado no es un identificador para un objeto de inscripción.
STATUS_INVALID_HANDLE
El identificador de objeto no es válido.
STATUS_INVALID_INFO_CLASS
El valor del parámetro EnlistmentInformationClass no es válido.
STATUS_INFO_LENGTH_MISMATCH
El valor del parámetro EnlistmentInformationLength no es válido.
STATUS_ACCESS_DENIED
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

ENLISTMENT_BASIC_INFORMATION

ENLISTMENT_INFORMATION_CLASS

Uso de las versiones Nt y Zw de las rutinas nativas de System Services

ZwCreateEnlistment

ZwOpenEnlistment

ZwSetInformationEnlistment