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 |
|