Condividi tramite


Funzione NtOpenThread

[Questa funzione può essere modificata o rimossa da Windows senza ulteriori preavviso. Usare invece la funzione OpenThread .

Apre un handle a un oggetto thread con l'accesso specificato.

Sintassi

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

Parametri

ThreadHandle [out]

Puntatore a una variabile che riceve l'handle dell'oggetto thread.

DesiredAccess [in]

Tipo di dati ACCESS_MASK che fornisce i tipi di accesso desiderati per l'oggetto thread.

ObjectAttributes [in]

Puntatore a una struttura OBJECT_ATTRIBUTES . Il membro ObjectName di questa struttura deve essere NULL.

Windows Server 2003 e Windows XP: Il membro ObjectName di questa struttura può puntare a un nome di oggetto. Se ObjectName non è NULL, il parametro ClientId deve essere NULL.

ClientId [in]

Puntatore a una struttura CLIENT_ID che identifica il thread il cui thread deve essere aperto.

Windows Server 2003 e Windows XP: Puntatore a una struttura CLIENT_ID che identifica il thread il cui thread deve essere aperto. Questo parametro può essere NULL. Se questo parametro non è NULL, il membro ObjectName della struttura a cui punta il parametro ObjectAttributes deve essere NULL.

Valore restituito

Restituisce un codice NTSTATUS o di errore.

Le forme e il significato dei codici di errore NTSTATUS sono elencati nel file di intestazione Ntstatus.h disponibile in WDK e sono descritti nella documentazione di WDK.

Commenti

Questa funzione non ha alcun file di intestazione associato. La libreria di importazione associata Ntdll.lib è disponibile in WDK. È anche possibile usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Ntdll.dll.

Requisiti

Requisito Valore
DLL
Ntdll.dll