Metodo ICertificateEnrollmentPolicyServerSetup::SetProperty (casetup.h)
Il metodo SetProperty specifica un valore di enumerazione CEPSetupProperty per la configurazione del servizio Web CEP (Certificate Enrollment Policy).
Sintassi
HRESULT SetProperty(
[in] CEPSetupProperty propertyId,
[in] 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 usare. |
| ENUM_CEPSETUPPROP_SSLCERTHASH | Il parametro pPropertyValue contiene un hash del certificato, se presente, usato durante l'autenticazione. ENUM_CEPSETUPPROP_AUTHENTICATION deve essere impostato su X509AuthCertificate. |
| ENUM_CEPSETUPPROP_KEYBASED_RENEWAL | Il parametro pPropertyValue specifica se configurare il server criteri di registrazione in una modalità che restituisce i criteri solo per i modelli KeyBasedRenewal. |
| ENUM_CEPSETUPPROP_URL | Non è possibile specificare questo valore. |
[in] pPropertyValue
Puntatore a una variabile VARIANT contenente il valore della proprietà.
Se si specifica ENUM_CEPSETUPPROP_AUTHENTICATION nel parametro propertyId, il sottotipo VARIANT deve essere VT_I2, VT_I4oVT_UII4 e l'argomento pPropertyValue deve essere una delle costanti seguenti:
- X509AuthKerberos
- X509AuthUsername
- X509AuthCertificate
Se si specifica ENUM_CEPSETUPPROP_SSLCERTHASH nel parametro propertyId , è necessario impostare il parametro pPropertyValue su un sottotipo VT_BSTR contenente un hash del certificato usato per l'autenticazione.
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 criteri di registrazione in una modalità che restituisce i criteri solo per i modelli KeyBasedRenewal.
Valore restituito
| Codice restituito | Descrizione |
|---|---|
|
L'argomento propertyId non è un membro del tipo di enumerazione CEPSetupProperty oppure si è tentato di impostare il valore di ENUM_CEPSETUPPROP_URL . |
|
Il parametro pPropertyValue non può essere NULL. |
|
L'oggetto ICertificateEnrollmentPolicyServerSetup non è stato inizializzato.
Il valore della proprietà ErrorString è impostato su "L'oggetto setup non è stato inizializzato. Inizializzare l'oggetto setup con il metodo InitializeInstallDefaults. |
|
Se si imposta la proprietà ENUM_CEPSETUPPROP_AUTHENTICATION , il sottotipo VARIANT deve essere VT_I2, VT_I4 o VT_UI4. |
Commenti
È necessario chiamare InitializeInstallDefaults prima di chiamare il metodo SetProperty .
Requisiti
| 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 |