Condividi tramite


Metodo ICertificateEnrollmentServerSetup::InitializeInstallDefaults (casetup.h)

Il metodo InitializeInstallDefaults inizializza l'oggetto ICertificateEnrollmentServerSetup con una configurazione predefinita.

Sintassi

HRESULT InitializeInstallDefaults();

Valore restituito

Codice restituito Descrizione
E_ACCESSDENIED
Un utente deve essere un amministratore della radice del dominio o dell'organizzazione. Un computer deve essere aggiunto al dominio.

Se l'utente non è un amministratore radice del dominio o dell'organizzazione, la proprietà ErrorString è impostata su:

"È necessario essere un membro del gruppo Enterprise Admins per eseguire il programma di installazione".

Se il computer non è aggiunto al dominio, la proprietà ErrorString è impostata su:

"Impossibile installare il servizio Web registrazione certificati o il servizio Web dei criteri di registrazione certificati in un computer che non è membro di un dominio".

HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
L'oggetto ICertificateEnrollmentServerSetup è già stato inizializzato. La proprietà ErrorString è impostata su:

"L'oggetto di installazione è già stato inizializzato. Questo oggetto non può essere inizializzato più volte."

Commenti

Questo metodo esegue le azioni seguenti:

  • Determina se l'oggetto ICertificateEnrollmentServerSetup è già stato inizializzato.
    Nota Se questo controllo ha esito negativo, il metodo imposta la proprietà ErrorString su "L'oggetto setup è già stato inizializzato. Questo oggetto non può essere inizializzato più volte."
     
  • Determina se l'utente è un amministratore della radice del dominio o dell'organizzazione.
    Nota Se questo controllo ha esito negativo, il metodo imposta la proprietà ErrorString su "È necessario essere un membro del gruppo Enterprise Admins per eseguire il programma di installazione".
     
  • Determina se il computer è aggiunto al dominio.
    Nota Se questo controllo non riesce, il metodo imposta la proprietà ErrorString su "Il servizio Web registrazione certificati o il servizio Web di registrazione certificati non può essere installato in un computer che non è membro di un dominio".
     
  • Imposta la procedura di autenticazione predefinita su Kerberos. È possibile chiamare SetProperty per modificare il metodo di autenticazione.
  • Determina se CES è installato in un computer che esegue Windows Server 2008 R2.
    Nota Se questo controllo ha esito negativo, il metodo imposta la proprietà ErrorString su "Il servizio Web registrazione certificati o il servizio Web di registrazione certificati deve essere installato in un server membro in una foresta di Active Directory in cui è stata eseguita correttamente la versione di Windows Server 2008 R2 di ADPrep /forestprep".
     
  • Imposta il contesto del server predefinito sull'account predefinito ApplicationPoolIdentity .
  • Imposta la proprietà ENUM_CESSETUPPROP_RENEWALONLY su FALSE.
  • Imposta la proprietà ENUM_CESSETUPPROP_URL è su "https:// computerDNSname/SanitizedCAShortName_CES_Kerberos/service.svc/ces" se esiste una configurazione ca valida. Se non esiste una configurazione valida, la proprietà ENUM_CESSETUPPROP_URL non è impostata. L'oggetto SanitizedCAShortName è il nome breve di sanificazione della CA. Per altre informazioni sui nomi sanificati, vedere GetConfig.
    Nota Se l'autorità di certificazione è una CA autonoma, la proprietà ErrorString è impostata su "Impossibile usare il servizio Web registrazione certificati con un'autorità di certificazione autonoma (CA). Può essere usato solo con una CA aziendale."
     
È necessario chiamare il metodo InitializeInstallDefaults prima di chiamare qualsiasi metodo diverso da UnInstall. Chiamare il metodo Install per installare il servizio configurato. Chiamare UnInstall in un nuovo oggetto ICertificateEnrollmentServerSetup per rimuovere il servizio.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione casetup.h
DLL Certocm.dll

Vedi anche

CESSetupProperty

ICertificateEnrollmentServerSetup