Metodo ISecurityCallContext::IsCallerInRole (comsvcs.h)
Determina se il chiamante diretto si trova nel ruolo specificato.
Sintassi
HRESULT IsCallerInRole(
[in] BSTR bstrRole,
[out] VARIANT_BOOL *pfInRole
);
Parametri
[in] bstrRole
Nome ruolo.
[out] pfInRole
TRUE se il chiamante è nel ruolo specificato; FALSE in caso contrario. Se il ruolo specificato non è definito per l'applicazione, viene restituito FALSE . Questo parametro è impostato su TRUE se la sicurezza basata sui ruoli non è abilitata.
Valore restituito
Questo metodo può restituire i valori restituiti standard E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED e E_FAIL, nonché i valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Il ruolo specificato nel parametro bstrRole è un ruolo riconosciuto e il risultato booleano restituito nel parametro pfIsInRole indica se il chiamante si trova in tale ruolo. |
|
Il ruolo specificato nel parametro bstrRole non esiste. |
Commenti
Utilizzare questo metodo per limitare l'accesso alle sezioni di codice che non devono essere eseguite a meno che il chiamante non sia un membro del ruolo specificato. I gruppi e gli utenti di Windows vengono assegnati ai ruoli di un'applicazione usando lo strumento di amministrazione di Servizi componenti. Per altre informazioni sui ruoli, vedere Sicurezza basata sui ruoli.
IsCallerInRole si applica solo al chiamante diretto del metodo attualmente in esecuzione. IsCallerInRole non si applica ad alcun altro chiamante nella sequenza di chiamata da cui è stato chiamato il metodo corrente. È tuttavia possibile ottenere informazioni su altri chiamanti nella sequenza usando il metodo della proprietà get_Item per ottenere la proprietà Callers dell'oggetto contesto di chiamata di sicurezza.
Poiché IsCallerInRole è TRUE quando la sicurezza basata su ruoli non è abilitata, è consigliabile chiamare IsSecurityEnabled prima di chiamare IsCallerInRole per assicurarsi che IsCallerInRolerestituisca informazioni utili.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | comsvcs.h |