NtOpenThread-Funktion
[Diese Funktion kann ohne weitere Ankündigung geändert oder aus Windows entfernt werden. Verwenden Sie stattdessen die OpenThread-Funktion .]
Öffnet ein Handle für ein Threadobjekt mit angegebenem 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 Threadobjekthandle empfängt.
-
DesiredAccess [in]
-
Ein ACCESS_MASK Datentyp, der die gewünschten Zugriffstypen für das Threadobjekt bereitstellt.
-
ObjectAttributes [in]
-
Ein Zeiger auf eine OBJECT_ATTRIBUTES-Struktur . Das ObjectName-Element dieser Struktur muss NULL sein.
Windows Server 2003 und Windows XP: Das ObjectName-Element 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 das ObjectName-Element der Struktur, auf die vom ObjectAttributes-Parameter verwiesen wird, NULL sein.
Rückgabewert
Gibt einen NTSTATUS- oder Fehlercode zurück.
Die Formen und die Bedeutung von NTSTATUS-Fehlercodes sind in der Im WDK verfügbaren Ntstatus.h-Headerdatei aufgeführt und in der WDK-Dokumentation beschrieben.
Bemerkungen
Diese Funktion verfügt über keine zugeordnete Headerdatei. Die zugehörige 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 zu erstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| DLL |
|