Metodo ICertificateEnrollmentServerSetup::SetProperty (casetup.h)

Articolo
02/23/2024

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

Condividi tramite