Metodo ICertAdmin2::GetMyRoles (certadm.h)

Articolo
03/14/2023

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

Condividi tramite