IX509EnrollmentPolicyServer::LoadPolicy method

The LoadPolicy method retrieves policy information from the certificate enrollment policy (CEP) server.

Syntax


HRESULT LoadPolicy(
  [in] X509EnrollmentPolicyLoadOption option
);

Parameters

option [in]

A value of the X509EnrollmentPolicyLoadOption enumeration that specifies how to retrieve policy from the policy server. This can be one of the following values.

ValueMeaning
LoadOptionDefault

Reload if the cache has expired.

LoadOptionCacheOnly

Always load from the cache even if it has expired. This option is not currently supported.

LoadOptionReload

Always reload.

LoadOptionRegisterForADChanges

Registers a thread to update a sequence number if there are changes to the template or the certification authority container. This value applies only to an Active Directory policy server.

 

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 codeDescription
E_INVALIDARG

The load option requested in the option parameter does not match any supported by the CEP server or you specified LoadOptionCacheOnly in the option parameter.

E_NOT_VALID_STATE

There was a problem with the lightweight directory access protocol (LDAP) used to locate the CEP server.

 

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Certenroll.h

IDL

Certenroll.idl

See also

IX509EnrollmentPolicyServer

 

 

Community Additions

ADD
Show: