nf-certenroll-ix509enrollmentpolicyserver-initialize.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:certenroll.IX509EnrollmentPolicyServer.Initialize	IX509EnrollmentPolicyServer::Initialize (certenroll.h)	Initializes an IX509EnrollmentPolicyServer object.	ContextAdministratorForceMachine ContextMachine ContextUser IX509EnrollmentPolicyServer interface [Security] Initialize method IX509EnrollmentPolicyServer.Initialize IX509EnrollmentPolicyServer::Initialize Initialize Initialize method [Security] Initialize method [Security] IX509EnrollmentPolicyServer interface X509AuthAnonymous X509AuthCertificate X509AuthKerberos X509AuthUsername certenroll/IX509EnrollmentPolicyServer::Initialize security.ix509enrollmentpolicyserver_initialize	security\ix509enrollmentpolicyserver_initialize.htm	security	b0d848a2-1bac-4a30-ae02-26d5af719688	12/05/2018	ContextAdministratorForceMachine, ContextMachine, ContextUser, IX509EnrollmentPolicyServer interface [Security],Initialize method, IX509EnrollmentPolicyServer.Initialize, IX509EnrollmentPolicyServer::Initialize, Initialize, Initialize method [Security], Initialize method [Security],IX509EnrollmentPolicyServer interface, X509AuthAnonymous, X509AuthCertificate, X509AuthKerberos, X509AuthUsername, certenroll/IX509EnrollmentPolicyServer::Initialize, security.ix509enrollmentpolicyserver_initialize	certenroll.h		Windows	Windows 7 [desktop apps only]	Windows Server 2008 R2 [desktop apps only]					Certenroll.idl								Windows			19H1	IX509EnrollmentPolicyServer::Initialize certenroll/IX509EnrollmentPolicyServer::Initialize	c++	APIRef kbSyntax	COM	Certenroll.h	IX509EnrollmentPolicyServer.Initialize

IX509EnrollmentPolicyServer::Initialize

-description

The Initialize method initializes an IX509EnrollmentPolicyServer object.

-parameters

-param bstrPolicyServerUrl [in]

A BSTR variable that contains the URL for the certificate enrollment policy server.

-param bstrPolicyServerId [in]

A BSTR variable that contains a unique ID for the certificate enrollment policy server. If this value is not NULL, it must match the ID string returned by the CEP response.

-param authFlags [in]

An X509EnrollmentAuthFlags enumeration value that specifies the client authentication type. This can be one of the following values.

Value	Meaning
X509AuthAnonymous	Anonymous authentication.
X509AuthKerberos	Kerberos authentication.
X509AuthUsername	Clear text user name and password authentication. Note  The user name and password are encrypted before transmission and are stored securely in the credential vault on the CEP server.
X509AuthCertificate	Client authentication certificate installed on the local computer and used by the server to verify the identity of the client.

-param fIsUnTrusted [in]

A Boolean value that specifies whether to allow an untrusted certification authority certificates.

-param context [in]

An X509CertificateEnrollmentContext enumeration value that specifies the nature of the end entity for which certificate enrollment is intended. This can be one of the following values.

Value	Meaning
ContextUser	The certificate is intended for an end user.
ContextMachine	The certificate is intended for a computer.
ContextAdministratorForceMachine	The certificate is being requested by an administrator acting on the behalf of a computer.

-returns

If the function succeeds, the function returns S_OK.

If the function fails, it returns an HRESULT value that indicates the error. Possible values include, but are not limited to, those in the following table. For a list of common error codes, see Common HRESULT Values.

Return code	Description
E_INVALIDARG	The bstrPolicyServerUrl parameter cannot be an empty string and must represent an HTTPS URL.
E_OUTOFMEMORY	There was not sufficient memory available for the strings specified in the bstrPolicyServerUrl or bstrPolicyServerId parameters.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	The IX509EnrollmentPolicyServer object has already been initialized.
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)	The value specified in the bstrPolicyServerId parameter is not NULL and does not equal the existing CEP ID value on the CEP server.

-see-also

IX509EnrollmentPolicyServer