Edit

Share via

IX509PolicyServerListManager::Initialize method (certenroll.h)

  • Article

The Initialize method initializes an IX509PolicyServerListManager object.

Syntax

HRESULT Initialize(
  [in] X509CertificateEnrollmentContext context,
  [in] PolicyServerUrlFlags             Flags
);

Parameters

[in] context

An X509CertificateEnrollmentContext enumeration value that specifies the nature of the end entity for which an issued certificate 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.

[in] Flags

A PolicyServerUrlFlags enumeration value that specifies where policy information is located. This can be a bitwise OR of the following values.

Value Meaning
PsfLocationGroupPolicy
 Policy information is specified in group policy by an administrator.
PsfLocationRegistry
 Policy information is specified in the registry.

Return value

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 Flags parameter must contain a bitwise OR of PsfLocationGroupPolicy and PsfLocationRegistry.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 The IX509PolicyServerListManager has already been initialized.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header certenroll.h
DLL CertEnroll.dll

See also

IX509PolicyServerListManager