Función ZwQueryInformationEnlistment (wdm.h)

Artículo
02/27/2024

La rutina ZwQueryInformationEnlistment recupera información sobre un objeto de inscripción especificado.

Sintaxis

NTSYSCALLAPI NTSTATUS ZwQueryInformationEnlistment(
  [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:

EnlistmentBasicInformation
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 autor de la llamada que usó 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 Servicios del sistema nativo de Windows.

En el caso de las llamadas desde controladores en modo kernel, las versiones NtXxx y ZwXxx de una rutina de Servicios del sistema nativo de Windows se pueden comportar 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(storport), PowerIrpDDis(wdm)