Bagikan melalui

IHostSecurityManager::SetSecurityContext Method

Mengatur konteks keamanan utas yang sedang dijalankan saat ini.

Sintaks

HRESULT SetSecurityContext (  
    [in]  EContextType eContextType,  
    [out] IHostSecurityContext** ppSecurityContext  
);

Parameter

eContextType
[in] Salah satu nilai EContextType, mengindikasikan jenis konteks apa yang ditempatkan oleh runtime bahasa umum (CLR) pada host.

ppSecurityContext
[out] Pointer ke alamat objek IHostSecurityContext baru.

Tampilkan Nilai

HRESULT Deskripsi
S_OK SetSecurityContext berhasil dikembalikan.
HOST_E_CLRNOTAVAILABLE Runtime bahasa umum belum dimuat ke dalam proses, atau runtime bahasa umum dalam status yaitu tidak dapat menjalankan kode aman atau memproses panggilan dengan sukses.
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

Runtime bahasa umum memanggil SetSecurityContext dalam beberapa skenario. Sebelum menjalankan konstruktor dan finalizer kelas dan modul, runtime bahasa umum memanggil SetSecurityContext untuk melindungi host dari kegagalan eksekusi. Kemudian runtime bahasa umum mengatur ulang konteks keamanan ke status aslinya setelah eksekusi konstruktor atau finalizer, dengan menggunakan panggilan lain ke SetSecurityContext. Pola serupa terjadi pada penyelesaian I/O. Jika host mengimplementasikan IHostIoCompletionManager, runtime bahasa umum memanggil SetSecurityContext setelah host memanggil ICLRIoCompletionManager::OnComplete.

Pada titik asinkron dalam utas pekerja, runtime bahasa umum memanggil SetSecurityContext di dalam ThreadPool.QueueUserWorkItem atau dalam IHostThreadPoolManager::QueueUserWorkItem, tergantung apakah host atau runtime bahasa umum yang mengimplementasikan kumpulan utas.

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

  • Last updated on