Metodo ICertificateEnrollmentPolicyServerSetup::SetProperty (casetup.h)

Articolo
03/14/2023

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
E_INVALIDARG	L'argomento propertyId non è un membro del tipo di enumerazione CEPSetupProperty oppure si è tentato di impostare il valore di ENUM_CEPSETUPPROP_URL .
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 setup con il metodo InitializeInstallDefaults.
HRESULT_FROM_WIN32(ERROR_CLUSTER_PROPERTY_DATA_TYPE_MISMATCH)	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

Vedi anche

Getproperty

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults

Condividi tramite