Función NtOpenThread

[Esta función se puede cambiar o quitar de Windows sin previo aviso. Use la función OpenThread en su lugar.

Abre un identificador en un objeto de subproceso con el acceso especificado.

Sintaxis

NTSTATUS NtOpenThread(
  _Out_ PHANDLE            ThreadHandle,
  _In_  ACCESS_MASK        DesiredAccess,
  _In_  POBJECT_ATTRIBUTES ObjectAttributes,
  _In_  PCLIENT_ID         ClientId
);

Parámetros

ThreadHandle [out]

Puntero a una variable que recibe el identificador del objeto de subproceso.

DesiredAccess [in]

Tipo de datos ACCESS_MASK que proporciona los tipos de acceso deseados para el objeto de subproceso.

ObjectAttributes [in]

Puntero a una estructura OBJECT_ATTRIBUTES . El miembro ObjectName de esta estructura debe ser NULL.

Windows Server 2003 y Windows XP: El miembro ObjectName de esta estructura puede apuntar a un nombre de objeto. Si ObjectName no es NULL, el parámetro ClientId debe ser NULL.

ClientId [in]

Puntero a una estructura CLIENT_ID que identifica el subproceso cuyo subproceso se va a abrir.

Windows Server 2003 y Windows XP: Puntero a una estructura CLIENT_ID que identifica el subproceso cuyo subproceso se va a abrir. Este parámetro puede ser NULL. Si este parámetro no es NULL, el miembro ObjectName de la estructura a la que apunta el parámetro ObjectAttributes debe ser NULL.

Valor devuelto

Devuelve un código de error o NTSTATUS .

Los formularios y la importancia de los códigos de error NTSTATUS se enumeran en el archivo de encabezado Ntstatus.h disponible en el WDK y se describen en la documentación de WDK.

Comentarios

Esta función no tiene ningún archivo de encabezado asociado. La biblioteca de importación asociada, Ntdll.lib está disponible en el WDK. También puede usar las funciones LoadLibrary y GetProcAddress para vincular dinámicamente a Ntdll.dll.

Requisitos

Requisito	Value
Archivo DLL	Ntdll.dll