Metodo ICertificateEnrollmentServerSetup::SetProperty (casetup.h)

  • Articolo

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

Sintassi

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

Parametri

[in] propertyId

Valore di enumerazione CESSetupProperty che specifica il valore della proprietà da recuperare.

[in] 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 .

Inoltre, se si imposta la proprietà ENUM_CESSETUPPROP_AUTHENTICATION , è necessario specificare uno dei valori seguenti nell'argomento pPropertyValue :

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate
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.
HRESULT_FROM_WIN32(ERROR_CLUSTER_PROPERTY_DATA_TYPE_MISMATCH)
 Se si imposta la proprietà ENUM_CESSETUPPROP_AUTHENTICATION , il sottotipo VARIANT deve essere VT_I2, VT_I4 o VT_UI4.

Commenti

Prima di chiamare SetProperty, è necessario chiamare InitializeInstallDefaults.

Non è possibile impostare la proprietà ENUM_CESSETUPPROP_URL .

Non è possibile impostare la ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY se il pool di applicazioni WSEnrollmentServer esiste già e WMI è stato inizializzato.

Se si imposta la proprietà ENUM_CESSETUPPROP_AUTHENTICATION, il sottotipo VARIANT deve essere VT_I2, VT_I4 oVT_UII4 e l'argomento pPropertyValue deve essere una delle costanti seguenti:

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate

Non è possibile impostare la proprietà ENUM_CESSETUPPROP_CACONFIG se il server di destinazione è un'autorità di certificazione autonoma. La proprietà ErrorString verrà impostata su "Impossibile usare il servizio Web registrazione certificati con un'autorità di certificazione autonoma (CA). Può essere usato solo con una CA aziendale."

.

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