Metodo ICertificateEnrollmentServerSetup::GetProperty (casetup.h)

Articolo
02/23/2024

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

Condividi tramite