IOCSPCAConfiguration::ProviderProperties property

The ProviderProperties property gets or sets information that provides certificate status responses. The revocation information provider configured in the ProviderCLSID property uses certificate revocation lists (CRLs) specified in this property to provide responses.

This property is read/write.

Syntax


HRESULT put_ProviderProperties(
  [in]  VARIANT Val
);

HRESULT get_ProviderProperties(
  [out] VARIANT *pVal
);

Property value

The status-response information to set.

Error codes

If the method succeeds, it returns S_OK.

If the method fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

If the method returns HRESULT_FROM_WIN32(ERROR_INVALID_STATE), either it failed to initialize a lock on the OCSPCAConfiguration object, or the object failed to initialize.

If the method returns HRESULT_FROM_WIN32(ERROR_OBJECT_NOT_FOUND), the ProviderProperties member of the OCSPCAConfiguration object failed to initialize.

If the method returns E_INVALIDARG, the pVal parameter was set to NULL.

Remarks

The VARIANT returned in pVal is an IOCSPPropertyCollection interface.

To work with revocation-information provider properties:

  1. Create an IOCSPPropertyCollection object.
  2. Call InitializeFromProperties and pass in the VARIANT, pVal, returned by the ProviderProperties property.
  3. Use the Methods and Properties of the IOCSPPropertyCollection interface.

The following table lists the possible IOCSPProperty Name values and their data types for the default revocation-information provider.

NameData type
BaseCrlDepends on BaseCrlUrl
BaseCrlUrl REG_MULTI_SZ
CrlUrlTimeoutDWORD
DeltaCrlDepends on BaseCrlUrl or DeltaCrlUrl
DeltaCrlUrlREG_MULTI_SZ
RefreshTimeOutDWORD
RevocationErrorCodeDWORD

 

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008 Datacenter, Windows Server 2008 Enterprise [desktop apps only]

Header

Certadm.h (include Certserv.h)

IDL

Certadm.idl

Library

Certadm.lib

DLL

Certadm.dll

IID

IID_IOCSPCAConfiguration is defined as AEC92B40-3D46-433F-87D1-B84D5C1E790D

See also

IOCSPCAConfiguration

 

 

Show: