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
Uso de las versiones Nt y Zw de las rutinas nativas de System Services