<div class="content"><p> </p><p>The GetCAPropertyInfo method retrieves a set of property
structures from the <span><a href="719b890d-62e6-4322-b9b1-1f34d11535b4#gt_c925d5d7-a442-4ba4-9586-5f94ccec847a" data-linktype="relative-path">CA</a></span>. The list of
properties is specified in section <span><a href="7c715f9f-db50-41c3-abfc-0021c6390d4e" data-linktype="relative-path">3.2.1.4.3.2</a></span>.</p><dl>
<dd>
<div><pre> HRESULT GetCAPropertyInfo(
   [in, string, unique, range(1, 1536)] wchar_t const * pwszAuthority,
   [out] long* pcProperty,
   [out, ref] CERTTRANSBLOB* pctbPropInfo
 );
</pre></div>
</dd></dl><p><b>pwszAuthority: </b>Contains the name of the CA.</p><p><b>pcProperty: </b>An integer value that contains the
number of property structures returned.</p><p><b>pctbPropInfo: </b>A <span><a href="d6bee093-d862-4122-8f2b-7b49102097dc" data-linktype="relative-path">CERTTRANSBLOB</a></span>
structure that contains zero or more <span><a href="8116912a-59e6-4849-83dd-77b39b6370e0" data-linktype="relative-path">CATRANSPROP</a></span>
structures. For more information about the CERTTRANSBLOB and CATRANSPROP
structures, see <span><a href="../ms-csra/d9e0f247-2b38-466d-934b-83093c6a11a5" data-linktype="relative-path">Common
Structures</a></span>. </p><p><b>Return Values: </b>For a successful invocation,
the CA MUST return 0. Otherwise, the CA MUST return a nonzero value.</p><p>The processing rules for this method are as follows.</p><p>If Config_CA_Interface_Flags contains the value
IF_NOREMOTEICERTREQUEST, the server SHOULD return 0x80094011
(CERTSRV_E_ENROLL_DENIED) to the client. <a id="Appendix_A_Target_107"></a><a aria-label="Product behavior note 107" href="c8bec234-0a53-4a7c-859d-2bb7b2537da5#Appendix_A_107" data-linktype="relative-path">&lt;107&gt;</a></p><p>If Config_CA_Interface_Flags contains the value
IF_ENFORCEENCRYPTICERTREQUEST and the RPC_C_AUTHN_LEVEL_PKT_PRIVACY
authentication level, as defined in <span><a href="../ms-rpce/290c38b1-92fe-4229-91e6-4fc376610c15" data-linktype="relative-path">[MS-RPCE]</a></span>
section <span><a href="../ms-rpce/425a7c53-c33a-4868-8e5b-2a850d40dc73" data-linktype="relative-path">2.2.1.1.8</a></span>,
is not specified on the RPC connection from the client, the CA MUST refuse to
establish a connection with the client by returning a nonzero error.<a id="Appendix_A_Target_108"></a><a aria-label="Product behavior note 108" href="c8bec234-0a53-4a7c-859d-2bb7b2537da5#Appendix_A_108" data-linktype="relative-path">&lt;108&gt;</a></p><p>When the CA receives this invocation, it MUST verify the CA
name that is passed in <i>pwszAuthority</i> by invoking the processing rules in
section <span><a href="a7fdfc72-b1e0-4882-93da-9aefdf468b83" data-linktype="relative-path">3.2.1.4.2.1.1</a></span> with
the <i>CANameString</i> input parameter set to the CA name passed in the <i>pwszAuthority</i>
parameter and the <i>EmptyNameAllowed</i> input parameter set to false. If
false is returned, the CA MUST return the E_INVALIDARG (0x80070057) error code
to the client.</p><p>If the CA name validation succeeded, the CA MUST return
success (0), MUST construct the returned CA properties information in the <i>pctbPropInfo</i>
field (as specified in section <span><a href="bc294d60-efe8-447c-a7a0-ee2e0952c214" data-linktype="relative-path">2.2.2.3.1</a></span>), and
MUST return the number of CA properties in the <i>pcProperty</i> parameter.</p></div>