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

Vedi anche

ISecurityCallContext

Sicurezza dei componenti a livello di codice

Sicurezza basata sui ruoli