Edit

Share via

ICertAdmin2::GetCAPropertyDisplayName method (certadm.h)

  • Article

The GetCAPropertyDisplayName method retrieves the property display name for a certification authority (CA) property. This method was first defined in the ICertAdmin interface.

Syntax

HRESULT GetCAPropertyDisplayName(
  [in]  const BSTR strConfig,
  [in]  LONG       PropId,
  [out] BSTR       *pstrDisplayName
);

Parameters

[in] strConfig

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  GetCAPropertyDisplayName 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.
 

[in] PropId

Specifies the property identifier. For information about this parameter, see the table in ICertAdmin2::GetCAProperty.

[out] pstrDisplayName

A pointer to the string representing the property's display name.

It is the responsibility of the caller to free the BSTR when done by calling SysFreeString.

Return value

C++

The return value is an HRESULT. A value of S_OK indicates the method was successful.

VB

A string that represents the property's display name.

Requirements

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