Metodo ICertificateEnrollmentServerSetup::GetProperty (casetup.h)

  • Articolo

Il metodo GetProperty recupera un valore di enumerazione CESSetupProperty per la configurazione del servizio Web registrazione certificati (CES).

Sintassi

HRESULT GetProperty(
  [in]  CESSetupProperty propertyId,
  [out] VARIANT          *pPropertyValue
);

Parametri

[in] propertyId

Valore di enumerazione CESSetupProperty che specifica il valore della proprietà da recuperare. Per altre informazioni, vedere la sezione Osservazioni.

[out] pPropertyValue

Puntatore a una variabile VARIANT contenente il valore della proprietà.

Valore restituito

Codice restituito Descrizione
E_INVALIDARG
 L'argomento propertyId non è un membro del tipo di enumerazione CESSetupProperty .
E_POINTER
 Il parametro pPropertyValue non può essere NULL.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 L'oggetto ICertificateEnrollmentServerSetup non è stato inizializzato.

Il valore della proprietà ErrorString è impostato su "L'oggetto setup non è stato inizializzato. Inizializzare l'oggetto setup con il metodo InitializeInstallDefaults.

Commenti

Il tipo di enumerazione CESSetupProperty contiene i valori seguenti:

  • ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY
  • ENUM_CESSETUPPROP_CACONFIG
  • ENUM_CESSETUPPROP_AUTHENTICATION
  • ENUM_CESSETUPPROP_SSLCERTHASH
  • ENUM_CESSETUPPROP_URL
  • ENUM_CESSETUPPROP_RENEWALONLY

I valori hanno il significato seguente:

  • La proprietà ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY è un valore VT_BOOL che specifica se il contesto del server è ApplicationPoolIdentity.
  • La proprietà ENUM_CESSETUPPROP_CACONFIG contiene una stringa di configurazione dell'autorità di certificazione (VT_BSTR) del formato computerDNSname/CAName in cui computerDNSname è il nome DNS completo del server e CAName è il nome comune della CA.
  • La proprietà ENUM_CESSETUPPROP_AUTHENTICATION specifica il tipo di procedura di autenticazione usata. Se il metodo GetProperty restituisce correttamente, l'argomento pPropertyValue conterrà una delle costanti seguenti:
    • X509AuthKerberos
    • X509AuthUsername
    • X509AuthCertificate
  • La proprietà ENUM_CESSETUPPROP_SSLCERTHASH contiene l'hash (VT_BSTR) del certificato usato durante l'autenticazione. La proprietà ENUM_CESSETUPPROP_AUTHENTICATION deve essere impostata su X509AuthCertificate.
  • La proprietà ENUM_CESSETUPPROP_URL contiene l'URL del servizio CES. Se il metodo GetProperty restituisce correttamente, l'argomento pPropertyValue conterrà un sottotipo VT_BSTR contenente un URL del modulo "https:// computerDNSname/ADPolicyProvider_ces_AuthenticationType/service.svc/ces" in cui il tipo di autenticazione può essere uno dei seguenti:
    • Kerberos
    • usernamepassword
    • certificato
  • La proprietà ENUM_CESSETUPPROP_RENEWALONLY è un valore VT_BOOL che specifica se CES può elaborare solo i rinnovi dei certificati.

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

ICertificateEnrollmentServerSetup