Metode ObjectContext::IsCallerInRole (comsvcs.h)

Artikel
02/26/2024

Menunjukkan apakah penelepon langsung objek berada dalam peran tertentu (baik secara langsung atau sebagai bagian dari grup).

Sintaks

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

Parameter

[in] bstrRole

Nama peran.

[out] pbInRole

TRUE jika penelepon berada dalam peran yang ditentukan; FALSE jika tidak. Parameter ini juga diatur ke TRUE jika keamanan tidak diaktifkan.

Nilai kembali

Metode ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG, E_OUTOFMEMORY, 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 pbIsInRole menunjukkan apakah pemanggil berada dalam peran tersebut.
CONTEXT_E_ROLENOTFOUND	Peran yang ditentukan dalam parameter bstrRole tidak ada.
E_UNEXPECTED	Terjadi kesalahan tidak terduga. Ini dapat terjadi jika satu objek meneruskan penunjuk ObjectContext ke objek lain dan objek lain memanggil IsCallerInRole menggunakan penunjuk ini. Penunjuk ObjectContext tidak valid di luar konteks objek yang awalnya mendapatkannya.

Keterangan

Gunakan metode ini untuk menentukan apakah pemanggil langsung dari metode yang saat ini dijalankan dikaitkan dengan peran tertentu. Peran adalah nama simbolis yang mewakili pengguna atau grup pengguna yang memiliki izin akses khusus ke semua komponen dalam aplikasi COM+ tertentu. Pengembang menentukan peran saat mereka membuat komponen, dan peran dipetakan ke pengguna atau grup individual pada waktu penyebaran.

IsCallerInRole hanya berlaku untuk penelepon langsung dari metode yang saat ini dijalankan. (Penelepon langsung adalah proses memanggil ke proses server saat ini. Ini bisa berupa proses klien dasar atau proses server.) IsCallerInRole tidak berlaku untuk proses yang memulai urutan panggilan dari mana metode saat ini dipanggil atau ke pemanggil lain dalam urutan tersebut.

Karena IsCallerInRole mengembalikan TRUE ketika objek yang memanggilnya dijalankan dalam proses klien, ada baiknya untuk memanggil IsSecurityEnabled sebelum memanggil IsCallerInRole. Jika keamanan tidak diaktifkan, IsCallerInRole tidak akan mengembalikan hasil yang akurat.

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

ObjectContext

Bagikan melalui