Metode ISecurityCallContext::IsCallerInRole (comsvcs.h)

Menentukan apakah penelepon langsung berada dalam peran yang ditentukan.

Sintaks

HRESULT IsCallerInRole(
  [in]  BSTR         bstrRole,
  [out] VARIANT_BOOL *pfInRole
);

Parameter

[in] bstrRole

Nama peran.

[out] pfInRole

TRUE jika pemanggil berada dalam peran yang ditentukan; FALSE jika tidak. Jika peran yang ditentukan tidak ditentukan untuk aplikasi, FALSE dikembalikan. Parameter ini diatur ke TRUE jika keamanan berbasis peran tidak diaktifkan.

Nilai kembali

Metode ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, dan E_FAIL, serta nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Peran yang ditentukan dalam parameter bstrRole adalah peran yang dikenali, dan hasil Boolean yang dikembalikan dalam parameter pfIsInRole menunjukkan apakah pemanggil berada dalam peran tersebut.
CONTEXT_E_ROLENOTFOUND	Peran yang ditentukan dalam parameter bstrRole tidak ada.

Keterangan

Gunakan metode ini untuk membatasi akses ke bagian kode yang tidak boleh dijalankan kecuali pemanggil adalah anggota peran yang ditentukan. Grup dan pengguna Windows ditetapkan ke peran aplikasi menggunakan alat administrasi Layanan Komponen. Untuk informasi selengkapnya tentang peran, lihat Keamanan Berbasis Peran.

IsCallerInRole hanya berlaku untuk penelepon langsung dari metode yang saat ini dijalankan. IsCallerInRole tidak berlaku untuk penelepon lain dalam urutan panggilan tempat metode saat ini dipanggil. Namun, Anda dapat memperoleh informasi tentang penelepon lain secara berurutan dengan menggunakan metode properti get_Item untuk mendapatkan properti Penelepon dari objek konteks panggilan keamanan.

Karena IsCallerInRoleTRUE ketika keamanan berbasis peran tidak diaktifkan, ada baiknya memanggil IsSecurityEnabled sebelum memanggil IsCallerInRole untuk memastikan bahwa IsCallerInRole mengembalikan informasi yang berguna.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	comsvcs.h

Lihat juga

ISecurityCallContext

Keamanan Komponen Terprogram

Keamanan Berbasis Peran