Edit

Share via

IX509EnrollmentPolicyServer::QueryChanges method (certenroll.h)

  • Article

The QueryChanges method retrieves a value that specifies whether the template or certification authority collections have changed in Active Directory.

Syntax

HRESULT QueryChanges(
  [out, retval] VARIANT_BOOL *pValue
);

Parameters

[out, retval] pValue

Pointer to a Boolean value that specifies whether the collections have changed.

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_NOT_VALID_STATE
 LoadOptionRegisterForADChanges was not specified in the option parameter of the LoadPolicy method.
E_POINTER
 The pValue parameter cannot be NULL.
OLE_E_BLANK
 The IX509EnrollmentPolicyServer object has not been initialized.

Remarks

The QueryChanges method is relevant only when you specify LoadOptionRegisterForADChanges in the option parameter of the LoadPolicy method. The method returns VARIANT_TRUE for either of the following cases:

  • The template collection in Active Directory has changed since the last time GetTemplates was called.
  • The certification authority collection in Active Directory has changed since the last time GetCAs was called.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header certenroll.h

See also

IX509EnrollmentPolicyServer