Compartir a través de


Función ZwMakeTemporaryObject (wdm.h)

La rutina ZwMakeTemporaryObject cambia los atributos de un objeto para que sea temporal.

Sintaxis

NTSYSAPI NTSTATUS ZwMakeTemporaryObject(
  [in] HANDLE Handle
);

Parámetros

[in] Handle

Identificador de un objeto de cualquier tipo.

Valor devuelto

ZwMakeTemporaryObject devuelve STATUS_SUCCESS correcto o el código de error NTSTATUS adecuado en caso de error.

Comentarios

ZwMakeTemporaryObject es una rutina genérica que funciona en cualquier tipo de objeto.

Un objeto es permanente si se creó con el atributo de objeto OBJ_PERMANENT especificado. (Para obtener más información sobre los atributos de objeto, vea InitializeObjectAttributes). Se crea un objeto permanente con un recuento de referencias de 1, por lo que no se elimina cuando un controlador la desreferencia.

Un objeto es temporal si no es permanente. ZwMakeTemporaryObject convierte el objeto especificado en un objeto temporal. Si el objeto ya es temporal, esta rutina no hace nada.

Un objeto temporal tiene un nombre solo siempre que su recuento de identificadores sea mayor que cero. Cuando el recuento de identificadores alcanza cero, el sistema elimina el nombre del objeto y ajusta correctamente el número de punteros del objeto.

Si la llamada a esta función se produce en modo de usuario, debe usar el nombre "NtMakeTemporaryObject" en lugar de "ZwMakeTemporaryObject".

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
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

InitializeObjectAttributes

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

ZwClose

ZwCreateDirectoryObject

ZwCreateFile