NtOpenThread-Funktion

[Diese Funktion kann ohne weitere Ankündigung geändert oder Windows entfernt werden. Verwenden Sie stattdessen die OpenThread-Funktion.]

Öffnet ein Handle für ein Threadobjekt mit dem angegebenen Zugriff.

Syntax

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

Parameter

ThreadHandle [ out]

Ein Zeiger auf eine Variable, die das Threadobjekthand handle empfängt.

DesiredAccess [ In]

Ein ACCESS _ MASK-Datentyp, der die gewünschten Zugriffstypen für das Threadobjekt bietet.

ObjectAttributes [ In]

Ein Zeiger auf eine OBJECT _ ATTRIBUTES-Struktur. Der ObjectName-Member dieser Struktur muss NULL sein.

Windows Server 2003 und Windows XP: Der ObjectName-Member dieser Struktur kann auf einen Objektnamen verweisen. Wenn ObjectName nicht NULL ist, muss der ClientId-Parameter NULL sein.

ClientId [ In]

Ein Zeiger auf eine _ CLIENT-ID-Struktur, die den Thread identifiziert, dessen Thread geöffnet werden soll.

Windows Server 2003 und Windows XP: Ein Zeiger auf eine _ CLIENT-ID-Struktur, die den Thread identifiziert, dessen Thread geöffnet werden soll. Dieser Parameter kann NULL sein. Wenn dieser Parameter nicht NULL ist, muss der ObjectName-Member der Struktur, auf die der ObjectAttributes-Parameter verweist, NULL sein.

Rückgabewert

Gibt einen NTSTATUS- oder Fehlercode zurück.

Die Formulare und die Bedeutung von NTSTATUS-Fehlercodes sind in der im WDK verfügbaren Ntstatus.h-Headerdatei aufgeführt und in der WDK-Dokumentation beschrieben.

Hinweise

Dieser Funktion ist keine Headerdatei zugeordnet. Die zugeordnete Importbibliothek Ntdll.lib ist im WDK verfügbar. Sie können auch die Funktionen LoadLibrary und GetProcAddress verwenden, um eine dynamische Verknüpfung mit Ntdll.dll.

Anforderungen

Anforderung Wert
DLL
Ntdll.dll