ICertificateEnrollmentServerSetup::GetProperty-Methode (casetup.h)

Artikel
02/23/2024

Die GetProperty-Methode ruft einen CESSetupProperty-Enumerationswert für die CES-Konfiguration (Certificate Enrollment Web Service) ab.

Syntax

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

Parameter

[in] propertyId

Ein CESSetupProperty-Enumerationswert , der den abzurufenden Eigenschaftswert angibt. Weitere Informationen finden Sie in den Hinweisen.

[out] pPropertyValue

Ein Zeiger auf eine VARIANT-Variable , die den Eigenschaftswert enthält.

Rückgabewert

Rückgabecode	Beschreibung
E_INVALIDARG	Das argument propertyId ist kein Member des CESSetupProperty-Enumerationstyps .
E_POINTER	Der pPropertyValue-Parameter darf nicht NULL sein.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)	Das ICertificateEnrollmentServerSetup-Objekt wurde nicht initialisiert. Der ErrorString-Eigenschaftswert ist auf "Das Setupobjekt wurde nicht initialisiert. Initialisieren Sie das Setupobjekt mit der InitializeInstallDefaults-Methode."

Hinweise

Der CESSetupProperty-Enumerationstyp enthält die folgenden Werte:

ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY
ENUM_CESSETUPPROP_CACONFIG
ENUM_CESSETUPPROP_AUTHENTICATION
ENUM_CESSETUPPROP_SSLCERTHASH
ENUM_CESSETUPPROP_URL
ENUM_CESSETUPPROP_RENEWALONLY

Diese Werte haben die folgenden Bedeutungen:

Die ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY-Eigenschaft ist ein VT_BOOL Wert, der angibt, ob der Serverkontext ApplicationPoolIdentity ist.
Die ENUM_CESSETUPPROP_CACONFIG-Eigenschaft enthält eine Konfigurationszeichenfolge der Zertifizierungsstelle (CA) (VT_BSTR) der Form computerDNSname/CAName , wobei computerDNSname der vollqualifizierte DNS-Name des Servers und CAName der allgemeine Name der Zertifizierungsstelle ist.
Die ENUM_CESSETUPPROP_AUTHENTICATION-Eigenschaft gibt den Typ der verwendeten Authentifizierungsprozedur an. Wenn die GetProperty-Methode erfolgreich zurückgegeben wird, enthält das pPropertyValue-Argument eine der folgenden Konstanten:
- X509AuthKerberos
- X509AuthBenutzername
- X509AuthCertificate
Die ENUM_CESSETUPPROP_SSLCERTHASH-Eigenschaft enthält den Hash (VT_BSTR) des zertifikats, das während der Authentifizierung verwendet wird. Die ENUM_CESSETUPPROP_AUTHENTICATION-Eigenschaft muss auf X509AuthCertificate festgelegt werden.
Die ENUM_CESSETUPPROP_URL-Eigenschaft enthält die CES-Dienst-URL. Wenn die GetProperty-Methode erfolgreich zurückgegeben wird, enthält das pPropertyValue-Argument einen VT_BSTR Subtyp, der eine URL des Formulars "https:// computerDNSname/ADPolicyProvider_ces_AuthenticationType/service.svc/ces" enthält, wobei der Authentifizierungstyp einer der folgenden sein kann:
- Kerberos
- usernamepassword
- Zertifikat
Die ENUM_CESSETUPPROP_RENEWALONLY-Eigenschaft ist ein VT_BOOL Wert, der angibt, ob CES nur Zertifikatverlängerungen verarbeiten kann.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	casetup.h
DLL	Certocm.dll

Weitere Informationen

ICertificateEnrollmentServerSetup

Freigeben über