IOCSPAdmin::get_OCSPServiceProperties method (certadm.h)

Article
04/02/2021

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