Export (0) Print
Expand All
1 out of 1 rated this helpful - Rate this topic

ICertConfig2 interface

The ICertConfig2 interface is one of two interfaces that provide functionality for retrieving the public configuration data (specified during client setup) for a Certificate Services server.

The ICertConfig2 interface is used to perform the following tasks:

  • Enumerate through the configuration strings for a Certificate Services server.
  • Retrieve the default configuration for a Certificate Services server.
  • Retrieve the details of a specific Certificate Services server configuration.
  • Reset the configuration of a Certificate Services server.
  • Specify a new path for the shared folder.

For each installation of Certificate Services, this public configuration data resides in the Certsrv.txt file, which exists in the shared folder, the Active Directory, or both. Any server set up to post its configuration information in Certsrv.txt is visible to ICertConfig2.

ICertConfig2 is defined in Certcli.h. When you create your program, however, use Certsrv.h as the include file. Certcli.dll provides the ICertConfig2 interface. In Windows Server 2003 and later operating systems, the type information for this interface is also in Certclil.dll, which is shipped with the Platform Software Development Kit (SDK).

Certificate Services interfaces support both apartment-threading and free-threading models. For better throughput, free threading is recommended.

Inheritance

The ICertConfig2 interface inherits and extends the ICertConfig interface.

Members

The ICertConfig2 interface inherits from ICertConfig and IDispatch. ICertConfig2 also has these types of members:

Methods

The ICertConfig2 interface has these methods.

MethodDescription
GetConfig

Gets the default configuration string (the server name and certification authority (CA) name) for a Certificate Services server.

(Inherited from ICertConfigICertConfig2CCertConfig)
GetField

Gets a specific field from the current record of the configuration database.

(Inherited from ICertConfigICertConfig2CCertConfig)
Next

Points to the next available Certificate Services server configuration in the configuration point.

(Inherited from ICertConfigICertConfig2CCertConfig)
Reset

Resets the configuration query state.

(Inherited from ICertConfigICertConfig2CCertConfig)
SetSharedFolder

Specifies a new path for the shared folder directory.

(Inherited from ICertConfig2CCertConfig)

 

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Certcli.h (include Certsrv.h)

Library

Certidl.lib

DLL

Certcli.dll

IID

IID_ICertConfig2 is defined as 7A18EDDE-7E78-4163-8DED-78E2C9CEE924

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.