Skip to content

Latest commit

 

History

History
73 lines (61 loc) · 3.06 KB

nn-certcli-icertconfig2.md

File metadata and controls

73 lines (61 loc) · 3.06 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NN:certcli.ICertConfig2
ICertConfig2 (certcli.h)
Provide functionality for retrieving the public configuration data (specified during client setup) for a Certificate Services server.
ICertConfig2
ICertConfig2 interface [Security]
ICertConfig2 interface [Security]
described
_certsrv_icertconfig2
certcli/ICertConfig2
security.icertconfig2
security\icertconfig2.htm
security
6bac5961-f9cc-4859-affa-aa7ed152ebfa
12/05/2018
ICertConfig2, ICertConfig2 interface [Security], ICertConfig2 interface [Security],described, _certsrv_icertconfig2, certcli/ICertConfig2, security.icertconfig2
certcli.h
Certsrv.h
Windows
None supported
Windows Server 2003 [desktop apps only]
Certidl.lib
Certcli.dll
Windows
19H1
ICertConfig2
certcli/ICertConfig2
c++
APIRef
kbSyntax
COM
Certcli.dll
ICertConfig2

ICertConfig2 interface

-description

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 from ICertConfig and IDispatch. ICertConfig2 also has these types of members: