Metodo ISecurityCallContext::IsUserInRole (comsvcs.h)

  • Articolo

Determina se l'utente specificato è nel ruolo specificato.

Sintassi

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

Parametri

[in] pUser

Puntatore al valore che contiene l'ID utente dell'utente la cui appartenenza al ruolo deve essere controllata. Se si intende passare l'identificatore di sicurezza (SID) a IsUserInRole, questo parametro deve soddisfare i requisiti seguenti: V_VT(pUser) == (VT_ARRAY|VT_UI1) && V_ARRAY(pUser)->cDims == 1.

[in] bstrRole

Nome ruolo.

[out] pfInRole

TRUE se l'utente è nel ruolo specificato; FALSE se non. Se il ruolo specificato non è definito per l'applicazione, viene restituito FALSE . Questo parametro è impostato su TRUE se la sicurezza basata su 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 l'utente si trova in tale ruolo.
CONTEXT_E_ROLENOTFOUND
 Il ruolo specificato nel parametro bstrRole non esiste.

Commenti

Usare questo metodo per limitare l'accesso alle sezioni di codice che non devono essere eseguite a meno che il chiamante non sia 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 su ruoli.

Poiché IsUserInRole è TRUE quando la sicurezza basata su ruoli non è abilitata, è consigliabile chiamare IsSecurityEnabled prima di chiamare IsUserInRole per assicurarsi che IsUserInRole restituisca informazioni utili.

Requisiti

   
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