<div class="content"><p> </p><p>The RemoteActivation (Opnum 0) method is used by clients to
request the activation of an object. It returns the bindings, the <span><a href="ba4c4d80-ef81-49b4-848f-9714d72b5c01#gt_74540339-daab-46ea-a8f9-fe8fca3b150c" data-linktype="relative-path">IPID</a></span>
for the <span><a href="ba4c4d80-ef81-49b4-848f-9714d72b5c01#gt_7d3f1934-0b0f-4aae-8ade-d7c76842a80c" data-linktype="relative-path">Remote Unknown</a></span>, and
the <span><a href="807a93f5-7321-4bdb-b88a-59059566afd3" data-linktype="relative-path">COMVERSION</a></span>
of the <span><a href="ba4c4d80-ef81-49b4-848f-9714d72b5c01#gt_5b284f60-ee33-4d15-9a7b-0fb82d7c6b68" data-linktype="relative-path">object exporter</a></span> that
hosts the object.</p><dl>
<dd>
<div><pre> error_status_t RemoteActivation(
   [in] handle_t hRpc,
   [in] ORPCTHIS* ORPCthis,
   [out] ORPCTHAT* ORPCthat,
   [in] GUID* Clsid,
   [in, string, unique] wchar_t* pwszObjectName,
   [in, unique] MInterfacePointer* pObjectStorage,
   [in] DWORD ClientImpLevel,
   [in] DWORD Mode,
   [in, range(1, MAX_REQUESTED_INTERFACES)] 
     DWORD Interfaces,
   [in, unique, size_is(Interfaces)] 
     IID* pIIDs,
   [in, range(0, MAX_REQUESTED_PROTSEQS)] 
     unsigned short cRequestedProtseqs,
   [in, size_is(cRequestedProtseqs)] 
     unsigned short aRequestedProtseqs[],
   [out] OXID* pOxid,
   [out] DUALSTRINGARRAY** ppdsaOxidBindings,
   [out] IPID* pipidRemUnknown,
   [out] DWORD* pAuthnHint,
   [out] COMVERSION* pServerVersion,
   [out] HRESULT* phr,
   [out, size_is(Interfaces), disable_consistency_check] 
     MInterfacePointer** ppInterfaceData,
   [out, size_is(Interfaces), disable_consistency_check] 
     HRESULT* pResults
 );
</pre></div>
</dd></dl><p><b>hRpc: </b> This MUST specify an <span><a href="ba4c4d80-ef81-49b4-848f-9714d72b5c01#gt_8a7f6700-8311-45bc-af10-82e10accd331" data-linktype="relative-path">RPC</a></span>
binding handle as specified 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/de240b5e-6487-485e-9086-5069977f89db" data-linktype="relative-path">3.2.2.3.1</a></span>
.</p><p><b>ORPCthis: </b> This MUST specify an ORPCTHIS. The
COMVERSION field SHOULD contain the negotiated version, as described in section
<span><a href="4f1175c3-d8e4-4a99-8d31-4e32f42a8beb" data-linktype="relative-path">1.7</a></span>.
The extensions field MUST be set to NULL.</p><p><b>ORPCthat: </b> This MUST contain an <span><a href="10ffacb5-c8b2-4b6a-bccc-9e515818661f" data-linktype="relative-path">ORPCTHAT</a></span>.
The extensions field MUST be set to NULL.</p><p><b>Clsid: </b> This MUST specify the <span><a href="ba4c4d80-ef81-49b4-848f-9714d72b5c01#gt_e433c806-6cb6-46a2-bb95-523df8818c99" data-linktype="relative-path">CLSID</a></span>
of the object to be created.</p><p><b>pwszObjectName: </b>This MAY contain a string to
be used to initialize the object.<a id="Appendix_A_Target_68"></a><a aria-label="Product behavior note 68" href="acc42954-4073-4f05-b850-efd562022077#Appendix_A_68" data-linktype="relative-path">&lt;68&gt;</a></p><p><b>pObjectStorage: </b> This MAY contain a marshaled <span><a href="ba4c4d80-ef81-49b4-848f-9714d72b5c01#gt_d2b5b331-4e5f-417f-92c5-38eef54176c2" data-linktype="relative-path">OBJREF</a></span>
to be used to initialize the object.<a id="Appendix_A_Target_69"></a><a aria-label="Product behavior note 69" href="acc42954-4073-4f05-b850-efd562022077#Appendix_A_69" data-linktype="relative-path">&lt;69&gt;</a></p><p><b>ClientImpLevel: </b> This MUST contain an
implementation-specific value that MUST be ignored on receipt.<a id="Appendix_A_Target_70"></a><a aria-label="Product behavior note 70" href="acc42954-4073-4f05-b850-efd562022077#Appendix_A_70" data-linktype="relative-path">&lt;70&gt;</a></p><p><b>Mode: </b>If the activation is for a <span><a href="ba4c4d80-ef81-49b4-848f-9714d72b5c01#gt_6f5973be-3408-4d7f-ae3e-7303e28bee94" data-linktype="relative-path">class
factory</a></span> reference, this parameter MUST be 0xFFFFFFFF. Otherwise, it
MUST be 0, except when the client specifies an initialization string in
pwszObjectName. If it does, this field MAY contain an implementation-specific
value.<a id="Appendix_A_Target_71"></a><a aria-label="Product behavior note 71" href="acc42954-4073-4f05-b850-efd562022077#Appendix_A_71" data-linktype="relative-path">&lt;71&gt;</a></p><p><b>Interfaces: </b>This MUST contain the number of
elements in pIIDs. This value MUST be between 1 and MAX_REQUESTED_INTERFACES;
see section <span><a href="d5ca7355-6503-4d0c-8616-0b4c479a264f" data-linktype="relative-path">2.2.28.1</a></span>.</p><p><b>pIIDs: </b> This MUST be an array of requested <span><a href="ba4c4d80-ef81-49b4-848f-9714d72b5c01#gt_76ad3105-3f05-479d-a40c-c9c8fa2ebd83" data-linktype="relative-path">IIDs</a></span>
on the object to be created.</p><p><b>cRequestedProtseqs: </b>This MUST contain the
number of elements in aRequestedProtseqs. This value MUST be between 1 and
MAX_REQUESTED_PROTSEQS (see section 2.2.28.1).</p><p><b>aRequestedProtseqs: </b>This MUST specify an array
of RPC <span><a href="ba4c4d80-ef81-49b4-848f-9714d72b5c01#gt_630dc751-f394-4ced-b924-e1ab05c44cac" data-linktype="relative-path">protocol sequence identifiers</a></span>
that the client supports.</p><p><b>pOxid: </b>This MUST contain an <span><a href="ba4c4d80-ef81-49b4-848f-9714d72b5c01#gt_602b473b-557d-40cc-8217-2cbdaa04c78d" data-linktype="relative-path">OXID</a></span>
value identifying the object exporter containing this object.</p><p><b>ppdsaOxidBindings: </b> This MUST contain the
string and security bindings supported by the object exporter and MUST NOT be
NULL. The returned string bindings SHOULD contain endpoints.</p><p><b>pipidRemUnknown: </b> This MUST contain the IPID
of the object exporter Remote Unknown object.</p><p><b>pAuthnHint: </b> This SHOULD contain an RPC <span><a href="ba4c4d80-ef81-49b4-848f-9714d72b5c01#gt_bfb9708e-9d05-4f79-8969-ef63f73aa434" data-linktype="relative-path">authentication
level</a></span> (see [MS-RPCE] section <span><a href="../ms-rpce/425a7c53-c33a-4868-8e5b-2a850d40dc73" data-linktype="relative-path">2.2.1.1.8</a></span>)
that denotes the minimum authentication level supported by the server. This MAY
be ignored by the client.<a id="Appendix_A_Target_72"></a><a aria-label="Product behavior note 72" href="acc42954-4073-4f05-b850-efd562022077#Appendix_A_72" data-linktype="relative-path">&lt;72&gt;</a></p><p><b>pServerVersion: </b> This MUST contain the
COMVERSION of the object exporter. For details, see section 2.2.11.</p><p><b>phr: </b>An HRESULT that indicates the result of
the activation. Success codes other than 0x00000000 MUST NOT be used. </p><p><b>ppInterfaceData: </b> This MUST contain an array
of <span><a href="21781a97-cb45-4655-82b0-02c4a1584603" data-linktype="relative-path">MInterfacePointer</a></span>
structures containing the results for each requested interface.</p><p><b>pResults: </b>If the <i>phr</i> parameter contains
0x00000000, this MUST contain an array of HRESULTs containing the results of
querying the object for each interface in <i>pIIDs</i>. Success codes other
than 0x00000000 MUST NOT be used in the results array. If the <i>phr</i>
parameter contains a failure value, this MUST contain an array of 0x00000000
values, one for each interface in <i>pIIDs</i>.</p><p>When processing this call, the <span><a href="ba4c4d80-ef81-49b4-848f-9714d72b5c01#gt_19f75354-9b0b-47cb-a00b-4ff196883b32" data-linktype="relative-path">object resolver</a></span> MUST
perform the operations specified in section <span><a href="f07e681a-16f9-4194-a453-63c7972f2161" data-linktype="relative-path">3.1.2.5.2.3</a></span>.</p></div>