Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Membuka token akses diskresi yang terkait dengan rangkaian yang sedang dijalankan.
Sintaks
HRESULT OpenThreadToken (
[in] DWORD dwDesiredAccess,
[in] BOOL bOpenAsSelf,
[out] HANDLE *phThreadToken
);
Parameter
dwDesiredAccess
[in] Mask nilai akses yang menentukan jenis akses yang diminta ke token rangkaian. Nilai-nilai ini ditentukan dalam fungsi OpenThreadToken Win32. Jenis akses yang diminta direkonsiliasi dengan daftar kontrol akses diskresi (DACL) token untuk menentukan jenis akses mana yang akan diberikan atau ditolak.
bOpenAsSelf
[in] true untuk menentukan bahwa pemeriksaan akses harus dilakukan menggunakan konteks keamanan dari proses rangkaian panggilan; false untuk menentukan bahwa pemeriksaan akses harus dilakukan menggunakan konteks keamanan untuk rangkaian panggilan itu sendiri. Jika thread meniru klien, konteks keamanan dapat berupa proses klien.
phThreadToken
[out] Pointer ke token akses yang baru dibuka.
Tampilkan Nilai
| HRESULT | Deskripsi |
|---|---|
| S_OK |
OpenThreadToken berhasil dikembalikan. |
| HOST_E_CLRNOTAVAILABLE | Runtime bahasa umum (CLR) belum dimuat ke dalam proses, atau CLR berada dalam status yang tidak dapat menjalankan kode terkelola atau tidak berhasil memproses panggilan. |
| HOST_E_TIMEOUT | Waktu panggilan habis. |
| HOST_E_NOT_OWNER | Pemanggil tidak memiliki kunci. |
| HOST_E_ABANDONED | Peristiwa dibatalkan saat rangkaian atau fiber yang diblokir sedang menunggunya. |
| E_FAIL | Kegagalan katastrofe yang tidak diketahui terjadi. Saat metode menampilkan E_FAIL, CLR tidak lagi dapat digunakan dalam proses. Panggilan berikutnya ke metode hosting menampilkan HOST_E_CLRNOTAVAILABLE. |
Keterangan
IHostSecurityManager::OpenThreadToken berperilaku mirip dengan fungsi Win32 yang sesuai dengan nama yang sama, kecuali bahwa fungsi Win32 memungkinkan pemanggil untuk meneruskan handel ke rangkaian arbitrer, sementara IHostSecurityManager::OpenThreadToken hanya membuka token yang terkait dengan rangkaian panggilan.
Jenis HANDLE tidak sesuai dengan COM; artinya, ukurannya khusus untuk sistem operasi dan membutuhkan penyusunan kustom. Dengan demikian, token ini hanya untuk digunakan dalam proses, antara CLR dan host.
Persyaratan
Platform: Lihat Persyaratan Sistem.
Header: MSCorEE.h
Pustaka: Disertakan sebagai sumber daya di MSCorEE.dll
Versi .NET Framework: Tersedia mulai dari 2.0