Partager via


Fonction NtOpenThread

[Cette fonction peut être modifiée ou supprimée de Windows sans préavis. Utilisez la fonction OpenThread à la place.]

Ouvre un handle à un objet thread avec l’accès spécifié.

Syntaxe

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

Paramètres

ThreadHandle [out]

Pointeur vers une variable qui reçoit le handle de l’objet thread.

DesiredAccess [in]

Un ACCESS_MASK type de données qui fournit les types d’accès souhaités pour l’objet thread.

ObjectAttributes [in]

Pointeur vers une structure OBJECT_ATTRIBUTES . Le membre ObjectName de cette structure doit avoir la valeur NULL.

Windows Server 2003 et Windows XP : Le membre ObjectName de cette structure peut pointer vers un nom d’objet. Si ObjectName n’a pas la valeur NULL, le paramètre ClientId doit avoir la valeur NULL.

ClientId [in]

Pointeur vers une structure CLIENT_ID qui identifie le thread dont le thread doit être ouvert.

Windows Server 2003 et Windows XP : Pointeur vers une structure de CLIENT_ID qui identifie le thread dont le thread doit être ouvert. Ce paramètre peut avoir la valeur NULL. Si ce paramètre n’est pas NULL, le membre ObjectName de la structure pointée par le paramètre ObjectAttributes doit avoir la valeur NULL.

Valeur retournée

Retourne un code d’erreur ou NTSTATUS .

Les formes et l’importance des codes d’erreur NTSTATUS sont répertoriés dans le fichier d’en-tête Ntstatus.h disponible dans le WDK et sont décrits dans la documentation WDK.

Notes

Cette fonction n’a aucun fichier d’en-tête associé. La bibliothèque d’importation associée, Ntdll.lib, est disponible dans le WDK. Vous pouvez également utiliser les fonctions LoadLibrary et GetProcAddress pour lier dynamiquement à Ntdll.dll.

Spécifications

Condition requise Valeur
DLL
Ntdll.dll