Export (0) Print
Expand All

IOCSPAdmin::OCSPServiceProperties property

The OCSPServiceProperties property gets an instance of an OCSPPropertyCollection object. This object represents the attributes of an Online Certificate Status Protocol (OCSP) responder service. After instantiating an OCSPAdmin object, a script or administration tool can use the retrieved IOCSPPropertyCollection interface to expose responder-service attributes.

This property is read-only.

Syntax


HRESULT get_OCSPServiceProperties(
  [out]  IOCSPPropertyCollection **ppVal
);

Property value

The address of a pointer to an interface for an OCSPPropertyCollection object.

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 OCSPAdmin object, or the object failed to initialize.

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

Remarks

The following table lists the possible Name-Value pairs for OCSP service properties.

NameValue
LogLevel

The Value of LogLevel must be one of the following constants.

Constant: CERTLOG_MINIMAL

DWORD: 0

Constant: CERTLOG_TERSE

DWORD: 1

Constant: CERTLOG_ERROR

DWORD: 2

Constant: CERTLOG_WARNING

DWORD: 3 (default)

Constant: CERTLOG_VERBOSE

DWORD: 4

Constant: CERTLOG_EXHAUSTIVE

DWORD: 5

AuditFilter

The Value of AuditFilter can be any bitwise combination of the following DWORD values.

Description: Audit OCSP service start/stop

DWORD: 0x1

Description: Changes to the OCSP configuration

DWORD: 0x2

Description: Requests submitted to the OCSP

DWORD: 0x4

Description: Changes to the OCSP security settings

DWORD: 0x8

ArrayController

The Value of ArrayController must be a string that represents the computer name of the OCSP server that acts as the array controller for an OCSP array configuration.

ArrayMembers

The Value of ArrayMembers can be a multiple-line string that represents the computer names of the OCSP servers that are part of an OCSP array configuration.

EnrollPollInterval

The Value of EnrollPollInterval must be a DWORD value from 0 to 24 that represents the number of hours between OCSP service certificate enrollment attempts. This interval determines how often the service checks the status of target certificates for a template change or pending validity change. When the service finds a change, it attempts to enroll for a new certificate.

 

Requirements

Minimum supported client

None supported

Minimum supported server

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

Header

Certadm.h (include Certsrv.h)

IDL

Certadm.idl

Library

Certadm.lib

DLL

Certadm.dll

IID

IID_IOCSPAdmin is defined as 322E830D-67DB-4FE9-9577-4596D9F09294

See also

IOCSPAdmin

 

 

Community Additions

ADD
Show:
© 2014 Microsoft