ICertRequest2::GetCAPropertyDisplayName method (certcli.h)
The GetCAPropertyDisplayName method retrieves the property display name for a certification authority (CA) property.
Syntax
HRESULT GetCAPropertyDisplayName(
[in] const BSTR strConfig,
[in] LONG PropId,
[out, retval] BSTR *pstrDisplayName
);
Parameters
[in] strConfig
Represents a valid configuration string for the CA in the form ComputerName\CAName, where ComputerName is the network name of the Certificate Services server, and CAName is the common name of the CA, as entered during Certificate Services setup. For information about the configuration string name, see ICertConfig.
[in] PropId
Specifies the property identifier. For information about this parameter, see the table in ICertAdmin2::GetCAProperty.
[out, retval] pstrDisplayName
A pointer to the BSTR that represents the property's display name. When you have finished using the BSTR, free it by calling the SysFreeString function.
Return value
C++
If the method succeeds, the method returns S_OK.If the method fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.
VB
The return value is a String that contains the property's display name.Remarks
The GetCAPropertyDisplayName method's functionality is similar to that of the ICertAdmin2::GetCAPropertyDisplayName method.
In the ICertAdmin2 method, the CA enforces that the caller has CA read access, which is usually only granted to CA officers and CA administrators.
By contrast, in the ICertRequest2 and ICertRequest3 implementations of the method, the CA does not require any access rights by default. Only Distributed Component Object Model (DCOM) access control lists (ACLs) are enforced; for a domain-joined CA, the DCOM ACLs allow Everyone access to the CAs. Everyone does not include Anonymous. The CA's request interface can be locked down by using the registry configuration to enforce that the caller has enroll access.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | certcli.h (include Certsrv.h) |
| Library | Certidl.lib |
| DLL | Certcli.dll |