Share via

3.1.2.4.1 IRPCRemoteObject_Create (Opnum 0)

  • Article

The IRPCRemoteObject_Create method creates a remote object on a server and returns it to the client.

 HRESULT IRPCRemoteObject_Create(
   [in] handle_t hRemoteBinding,
   [out] PRPCREMOTEOBJECT* ppRemoteObj
 );

hRemoteBinding: MUST be a client-generated RPC binding handle ([C706] section 2.3) by using a Universal Naming Convention (UNC) name that MUST uniquely identify a print server on the network.

ppRemoteObj: MUST be a remote object context handle returned by the server. It MUST be a non-NULL value.

Return Values: This method MUST return zero to indicate success, or an HRESULT error value ([MS-ERREF] section 2.1.1) to indicate failure. The client MUST consider all error return values fatal and report them to the higher-level caller.

Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].