Bagikan melalui


IHostSecurityManager::OpenThreadToken Method

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

Lihat juga