Edit

Share via

IOCSPAdmin::get_OCSPServiceProperties method (certadm.h)

  • Article

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(
  IOCSPPropertyCollection **ppVal
);

Parameters

ppVal

Return value

None

Remarks

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

Name Value
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

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2008 Datacenter, Windows Server 2008 Enterprise [desktop apps only]
Target Platform Windows
Header certadm.h (include Certsrv.h)
Library Certadm.lib
DLL Certadm.dll

See also

IOCSPAdmin