Fungsi NtOpenThread

[Fungsi ini dapat diubah atau dihapus dari Windows tanpa pemberitahuan lebih lanjut. Gunakan fungsi OpenThread sebagai gantinya.]

Membuka handel ke objek utas dengan akses yang ditentukan.

Sintaks

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

Parameter

ThreadHandle [out]

Penunjuk ke variabel yang menerima handel objek utas.

DesiredAccess [in]

Jenis data ACCESS_MASK yang menyediakan jenis akses yang diinginkan untuk objek utas.

ObjectAttributes [in]

Penunjuk ke struktur OBJECT_ATTRIBUTES . Anggota ObjectName dari struktur ini harus NULL.

Windows Server 2003 dan Windows XP: Anggota ObjectName dari struktur ini dapat menunjuk ke nama objek. Jika ObjectName bukan NULL, parameter ClientId harus NULL.

ClientId [in]

Penunjuk ke struktur CLIENT_ID yang mengidentifikasi utas yang utasnya akan dibuka.

Windows Server 2003 dan Windows XP: Penunjuk ke struktur CLIENT_ID yang mengidentifikasi utas yang utasnya akan dibuka. Parameter ini bisa NULL. Jika parameter ini bukan NULL, anggota ObjectName dari struktur yang ditujukkan oleh parameter ObjectAttributes harus NULL.

Nilai kembali

Mengembalikan NTSTATUS atau kode kesalahan.

Formulir dan signifikansi kode kesalahan NTSTATUS tercantum dalam file header Ntstatus.h yang tersedia di WDK, dan dijelaskan dalam dokumentasi WDK.

Keterangan

Fungsi ini tidak memiliki file header terkait. Pustaka impor terkait, Ntdll.lib tersedia di WDK. Anda juga dapat menggunakan fungsi LoadLibrary dan GetProcAddress untuk menautkan secara dinamis ke Ntdll.dll.

Persyaratan