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 |
|---|---|
|
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. |
|
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 |