Metodo ICertificateEnrollmentPolicyServerSetup::GetProperty (casetup.h)

Articolo
08/22/2023

Il metodo GetProperty recupera un valore di enumerazione CEPSetupProperty per la configurazione del servizio Web CEP (Certificate Enrollment Policy).

Sintassi

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

Parametri

[in] propertyId

Valore dell'enumerazione CEPSetupProperty che specifica il valore della proprietà da impostare. I valori seguenti sono validi.

Valore	Descrizione
ENUM_CEPSETUPPROP_AUTHENTICATION	Il parametro pPropertyValue contiene un valore che identifica il tipo di autenticazione da utilizzare.
ENUM_CEPSETUPPROP_SSLCERTHASH	Il parametro pPropertyValue contiene un hash del certificato, se presente, usato durante l'autenticazione.
ENUM_CEPSETUPPROP_KEYBASED_RENEWAL	Il parametro pPropertyValue specifica se configurare il server dei criteri di registrazione in una modalità che restituisce i criteri solo per i modelli KeyBasedRenewal.
ENUM_CEPSETUPPROP_URL	Contiene l'URL del servizio CEP. Se il metodo GetProperty restituisce correttamente, l'argomento pPropertyValue conterrà un sottotipo VT_BSTR che contiene un URL del formato "https:// computerDNSname/ADPolicyProvider_cep_AuthenticationType/service.svc/cep" in cui il tipo di autenticazione può essere uno dei seguenti: Kerberos usernamepassword certificato

[out] pPropertyValue

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

Se si specifica ENUM_CEPSETUPPROP_AUTHENTICATION nel parametro propertyId , il parametro pPropertyValue conterrà una delle costanti seguenti se il metodo GetProperty restituisce correttamente:

X509AuthKerberos
X509AuthUsername
X509AuthCertificate

Se si specifica ENUM_CEPSETUPPROP_SSLCERTHASH nel parametro propertyId , il parametro pPropertyValue conterrà un sottotipo VT_BSTR che contiene l'hash se il metodo GetProperty restituisce correttamente.

Se si specifica ENUM_CEPSETUPPROP_AUTHENTICATION nel parametro propertyId , il parametro pPropertyValue contiene la procedura di autenticazione.

Se si specifica ENUM_CEPSETUPPROP_URL nel parametro propertyId , il parametro pPropertyValue contiene l'URL del servizio Web CEP (Certificate Enrollment Policy).

Se si specifica ENUM_CEPSETUPPROP_KEYBASED_RENEWAL nel parametro propertyId , è necessario impostare il parametro pPropertyValue sul sottotipo VT_BOOL che indica se configurare il server dei criteri di registrazione in una modalità che restituisce i criteri solo per i modelli KeyBasedRenewal.

Valore restituito

Codice restituito	Descrizione
E_INVALIDARG	L'argomento propertyId non è un membro del tipo di enumerazione CEPSetupProperty .
E_POINTER	Il parametro pPropertyValue non può essere NULL.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)	L'oggetto ICertificateEnrollmentPolicyServerSetup non è stato inizializzato. Il valore della proprietà ErrorString è impostato su "L'oggetto setup non è stato inizializzato. Inizializzare l'oggetto di installazione con il metodo InitializeInstallDefaults."

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

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults

SetProperty

Condividi tramite