Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The RemoteGetClassObject (Opnum 3) method is used by clients to create an object reference for the class factory object.
-
HRESULT RemoteGetClassObject( [in] handle_t rpc, [in] ORPCTHIS* orpcthis, [out] ORPCTHAT* orpcthat, [in, unique] MInterfacePointer* pActProperties, [out] MInterfacePointer** ppActProperties );
rpc: This MUST specify an RPC binding handle as specified in [MS-RPCE] section 3.2.2.3.1.
orpcthis: This MUST specify an ORPCTHIS. The COMVERSION field SHOULD contain the negotiated version as specified in section 2.2.11. The extensions field MUST be set to NULL.
orpcthat: This MUST contain an ORPCTHAT. The extensions field MUST be set to NULL.
pActProperties: This MUST specify an MInterfacePointer that MUST contain an OBJREF_CUSTOM with a CLSID field set to CLSID_ActivationPropertiesIn (section 1.9) and a pObjectData field that MUST contain an activation properties BLOB (section 2.2.22). The iid field of the OBJREF portion of the structure MUST be set to IID_IActivationPropertiesIn (see section 1.9). An implementation MAY use this value as the IID of an interface with the local IDL attribute (section 2.2.27).<73>
-
The activation properties BLOB MUST contain properties marked Required in the following table and MAY contain properties marked Optional.
-
Property Name
Section
Required or Optional
InstantiationInfoData
Required
ScmRequestInfoData
Required
LocationInfoData
Required
SecurityInfoData
Optional
ActivationContextInfoData
Optional
InstanceInfoData
Optional
SpecialPropertiesData
Optional
-
Servers SHOULD ignore properties that they do not recognize.<74>
ppActProperties: This MUST contain an MInterfacePointer that MUST contain an OBJREF_CUSTOM with a CLSID field set to CLSID_ActivationPropertiesOut (section 1.9) and a pObjectData field that MUST contain an activation properties BLOB (section 2.2.22). The iid field of the OBJREF portion of the structure MUST be set to IID_ IActivationPropertiesOut (see section 1.9). An implementation MAY use this value as the IID of an interface with the local IDL attribute (section 2.2.27).<75>
-
The activation properties BLOB MUST contain all properties listed in the following table. Clients SHOULD ignore properties that they do not recognize.
-
Property Name
Section
Required or Optional
ScmReplyInfoData
Required
PropsOutInfo
Required
When processing this call, the object resolver MUST perform the operations specified in section 3.1.2.5.2.3.