Metodo ICertAdmin2::GetMyRoles (certadm.h)

  • Articolo

Il metodo GetMyRoles recupera i ruoli dell'autorità di certificazione (CA) del chiamante.

Sintassi

HRESULT GetMyRoles(
  [in]  const BSTR strConfig,
  [out] LONG       *pRoles
);

Parametri

[in] strConfig

Valore stringa che rappresenta una stringa di configurazione valida per la CA nel formato NOMECOMPUTER\CANAME, dove COMPUTERNAME è il nome di rete del server servizi certificati e CANAME è il nome comune della CA, come immesso durante l'installazione di Servizi certificati. Per informazioni sul nome della stringa di configurazione, vedere ICertConfig.

ImportanteGetMyRoles non cancella la cache interna quando viene modificata la stringa di configurazione. Quando si modifica la stringa di configurazione per la CA, è necessario creare un'istanza di un nuovo oggetto ICertAdmin e chiamare di nuovo questo metodo con la nuova stringa di configurazione.
 

[out] pRoles

Puntatore a un valore LONG che rappresenta i ruoli CA recuperati per il chiamante. Può trattarsi di una combinazione bit per bit di zero o più dei valori seguenti.

Valore Significato
CA_ACCESS_ADMIN
0x1
 Il chiamante ha la funzionalità di amministratore CA.
CA_ACCESS_AUDITOR
0x4
 Il chiamante ha capacità di controllo ca.
CA_ACCESS_ENROLL
0x200
 Il chiamante ha accesso alla registrazione.
CA_ACCESS_OFFICER
0x2
 Il chiamante ha la capacità del responsabile della CA.
CA_ACCESS_OPERATOR
0x8
 Il chiamante ha la funzionalità di backup della CA.
CA_ACCESS_READ
0x100
 Il chiamante ha accesso in lettura ca.

Valore restituito

C++

Se la funzione ha esito positivo, il valore restituito viene S_OK.

Se la funzione ha esito negativo, il valore restituito è un valore HRESULT che indica l'errore. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

VB

Il valore restituito è un valore Long che rappresenta i ruoli CA recuperati per il chiamante. Può trattarsi di una combinazione bit per bit di zero o più dei valori seguenti.
Codice/valore restituito Descrizione
CA_ACCESS_ADMIN
0x1
 Il chiamante ha la funzionalità di amministratore CA.
CA_ACCESS_AUDITOR
0x4
 Il chiamante ha capacità di controllo ca.
CA_ACCESS_ENROLL
0x200
 Il chiamante ha accesso alla registrazione.
CA_ACCESS_OFFICER
0x2
 Il chiamante ha la capacità del responsabile della CA.
CA_ACCESS_OPERATOR
0x8
 Il chiamante ha la funzionalità di backup della CA.
CA_ACCESS_READ
0x100
 Il chiamante ha accesso in lettura.

Requisiti

   
Client minimo supportato Nessuno supportato
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione certadm.h (include Certsrv.h)
Libreria Certidl.lib
DLL Certadm.dll

Vedi anche

ICertAdmin2