Metode ISecurityCallContext::IsUserInRole (comsvcs.h)

Menentukan apakah pengguna yang ditentukan berada dalam peran yang ditentukan.

Sintaks

HRESULT IsUserInRole(
  [in]  VARIANT      *pUser,
  [in]  BSTR         bstrRole,
  [out] VARIANT_BOOL *pfInRole
);

Parameter

[in] pUser

Pointer ke nilai yang memegang ID Pengguna pengguna yang keanggotaan perannya akan diperiksa. Jika Anda ingin meneruskan pengidentifikasi keamanan (SID) ke IsUserInRole, parameter ini harus memenuhi persyaratan berikut: V_VT(pUser) == (VT_ARRAY|VT_UI1) && V_ARRAY(pUser)->cDims == 1.

[in] bstrRole

Nama peran.

[out] pfInRole

TRUE jika pengguna 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 pengguna 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.

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

Persyaratan

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