Función ZwSetInformationEnlistment (wdm.h)

La rutina ZwSetInformationEnlistment establece información para un objeto de inscripción especificado.

Sintaxis

NTSYSCALLAPI NTSTATUS ZwSetInformationEnlistment(
  [in] HANDLE                       EnlistmentHandle,
  [in] ENLISTMENT_INFORMATION_CLASS EnlistmentInformationClass,
  [in] PVOID                        EnlistmentInformation,
  [in] ULONG                        EnlistmentInformationLength
);

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_SET_INFORMATION acceso al objeto .

[in] EnlistmentInformationClass

Valor de enumeración con tipo ENLISTMENT_INFORMATION_CLASS que especifica el tipo de información que se va a establecer. Este valor debe ser EnlistmentRecoveryInformation.

Los valores EnlistmentBasicInformation y EnlistmentFullInformation de la enumeración no se usan con ZwSetInformationEnlistment.

[in] EnlistmentInformation

Puntero a un búfer asignado por el autor de la llamada que contiene información de recuperación definida por el autor de la llamada para la inscripción.

[in] EnlistmentInformationLength

Longitud, en bytes, del búfer al que apunta el parámetro EnlistmentInformation .

Valor devuelto

ZwSetInformationEnlistment 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 usar la rutina ZwSetInformationEnlistment para establecer información de recuperación para una inscripción. KTM escribe la información de recuperación en el flujo de registro y el administrador de recursos puede llamar a ZwQueryInformationEnlistment para leer esta información de la secuencia de registro en cualquier momento.

Cada llamada posterior a ZwSetInformationEnlistment elimina la información de recuperación que la llamada anterior especificó antes de almacenar la nueva información de recuperación.

Para obtener más información sobre cómo usar ZwSetInformationEnlistment, consulte Uso de secuencias de registro con KTM.

NtSetInformationEnlistment y ZwSetInformationEnlistment 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)

Consulte también

ENLISTMENT_INFORMATION_CLASS

Uso de las versiones Nt y Zw de las rutinas nativas de Servicios del sistema

ZwCreateEnlistment

ZwOpenEnlistment

ZwQueryInformationEnlistment