Compartilhar via


Função NtOpenThread

[Essa função pode ser alterada ou removida do Windows sem aviso prévio. Em vez disso, use a função OpenThread .]

Abre um identificador para um objeto de thread com o acesso especificado.

Sintaxe

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

Parâmetros

ThreadHandle [out]

Um ponteiro para uma variável que recebe o identificador de objeto de thread.

DesiredAccess [in]

Um tipo de dados ACCESS_MASK que fornece os tipos de acesso desejados para o objeto de thread.

ObjectAttributes [in]

Um ponteiro para uma estrutura OBJECT_ATTRIBUTES . O membro ObjectName dessa estrutura deve ser NULL.

Windows Server 2003 e Windows XP: O membro ObjectName dessa estrutura pode apontar para um nome de objeto. Se ObjectName não for NULL, o parâmetro ClientId deverá ser NULL.

ClientId [in]

Um ponteiro para uma estrutura CLIENT_ID que identifica o thread cujo thread deve ser aberto.

Windows Server 2003 e Windows XP: Um ponteiro para uma estrutura CLIENT_ID que identifica o thread cujo thread deve ser aberto. Este parâmetro pode ser NULL. Se esse parâmetro não for NULL, o membro ObjectName da estrutura apontada pelo parâmetro ObjectAttributes deverá ser NULL.

Valor retornado

Retorna um código de erro ou NTSTATUS .

Os formulários e a significância dos códigos de erro NTSTATUS estão listados no arquivo de cabeçalho Ntstatus.h disponível no WDK e são descritos na documentação do WDK.

Comentários

Essa função não tem nenhum arquivo de cabeçalho associado. A biblioteca de importação associada, Ntdll.lib, está disponível no WDK. Você também pode usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Ntdll.dll.

Requisitos

Requisito Valor
DLL
Ntdll.dll