Skip to content

Latest commit

 

History

History
229 lines (186 loc) · 6.33 KB

nf-certadm-icertadmin2-setcaproperty.md

File metadata and controls

229 lines (186 loc) · 6.33 KB
Raw
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
NF:certadm.ICertAdmin2.SetCAProperty
ICertAdmin2::SetCAProperty (certadm.h)
Sets a property value for the certification authority (CA).
CR_PROP_KRACERT
CR_PROP_KRACERTCOUNT
CR_PROP_KRACERTUSEDCOUNT
CR_PROP_ROLESEPARATIONENABLED
CR_PROP_TEMPLATES
ICertAdmin2 interface [Security]
SetCAProperty method
ICertAdmin2.SetCAProperty
ICertAdmin2::SetCAProperty
PROPTYPE_BINARY
PROPTYPE_DATE
PROPTYPE_LONG
PROPTYPE_STRING
SetCAProperty
SetCAProperty method [Security]
SetCAProperty method [Security]
ICertAdmin2 interface
certadm/ICertAdmin2::SetCAProperty
security.icertadmin2_setcaproperty
security\icertadmin2_setcaproperty.htm
security
29570a8f-41d4-4c6a-88d0-97d6aa9d0784
12/05/2018
CR_PROP_KRACERT, CR_PROP_KRACERTCOUNT, CR_PROP_KRACERTUSEDCOUNT, CR_PROP_ROLESEPARATIONENABLED, CR_PROP_TEMPLATES, ICertAdmin2 interface [Security],SetCAProperty method, ICertAdmin2.SetCAProperty, ICertAdmin2::SetCAProperty, PROPTYPE_BINARY, PROPTYPE_DATE, PROPTYPE_LONG, PROPTYPE_STRING, SetCAProperty, SetCAProperty method [Security], SetCAProperty method [Security],ICertAdmin2 interface, certadm/ICertAdmin2::SetCAProperty, security.icertadmin2_setcaproperty
certadm.h
Certsrv.h
Windows
None supported
Windows Server 2003 [desktop apps only]
Certidl.lib
Certadm.dll
Windows
19H1
ICertAdmin2::SetCAProperty
certadm/ICertAdmin2::SetCAProperty
c++
APIRef
kbSyntax
COM
Certadm.dll
ICertAdmin2.SetCAProperty

ICertAdmin2::SetCAProperty

-description

The SetCAProperty method sets a property value for the certification authority (CA).

-parameters

-param strConfig [in]

String value that represents a valid configuration string for the CA in the form COMPUTERNAME\CANAME, where COMPUTERNAME is the Certificate Services server's network name, and CANAME is the common name of the CA, as entered during Certificate Services setup. For information about the configuration string name, see ICertConfig.

Important  SetCAProperty does not clear the internal cache when the configuration string is changed. When you change the configuration string for the CA, you must instantiate a new ICertAdmin object and call this method again with the new configuration string.

 

-param PropId [in]

Specifies one of the following property identifiers.

For information about all CA properties, including those that are read-only, see ICertAdmin2::GetCAProperty.

Value Meaning
CR_PROP_KRACERT
 The CA's key recovery agent (KRA) certificate.

Data format: binary, indexed.
CR_PROP_KRACERTCOUNT
 Number of KRA certificates for the CA.

Data format: Long.
CR_PROP_KRACERTUSEDCOUNT
 Number of KRA certificates used by the CA.

Data format: Long.
CR_PROP_ROLESEPARATIONENABLED
 Value that specifies whether role separation is enabled.

Data format: Long.
CR_PROP_TEMPLATES
 List of templates supported by the CA.

Data format: String.

-param PropIndex [in]

If the PropId parameter is indexed, the zero-based index to use when retrieving the property value. If PropId is not indexed, this value is ignored.

-param PropType [in]

Specifies the type of the property. This parameter can be one of the following values.

Value Meaning
PROPTYPE_LONG
 Signed Long data.
PROPTYPE_DATE
 Date/Time (reserved for future use).
PROPTYPE_BINARY
 Binary data.
PROPTYPE_STRING
 Unicode String data.

-param pvarPropertyValue [in]

C++ A pointer to a VARIANT that specifies the property value.
VB A Variant that specifies the property value.

-returns

VB

If the function is successful, the return value is S_OK.

If the function fails, the return value is an HRESULT that indicates the error. For a list of common error codes, see Common HRESULT Values.

-see-also

ICertAdmin2

ICertAdmin2::GetCAProperty