Share via

3.2.4.4.5.1 IDMRemoteServer::CreateRemoteObject (Opnum 3)

  • Article

The CreateRemoteObject method creates a disk management server, on the remote machine specified by RemoteComputerName, by invoking DCOM with the class GUID of Disk Management server and the name of the remote machine, which starts the disk management server on the remote machine. The method negotiates for the interface as described in section 3.1.3, and as illustrated in section 4. The client holds a reference to the IDMRemoteServer interface binding on the server, until the client has received an IVolumeClient, or IVolumeClient3 interface binding to the remote server. The client MAY then release the IDMRemoteServer interface on the server.

 HRESULT CreateRemoteObject(
   [in] unsigned long cMax,
   [in, max_is(cMax)] wchar_t* RemoteComputerName
 );

cMax: Length of RemoteComputerName (in Unicode characters), including the terminating null character.

RemoteComputerName: Null-terminated Unicode string that specifies the name of the computer on which the server is to be activated. All UNC names ("\\server" or "server") and DNS names ("domain.com", "example.microsoft.com", or "135.5.33.19") are allowed.

Return Values: The method MUST return 0 or a nonerror HRESULT on success, or an implementation-specific nonzero error code on failure (as specified in [MS-ERREF]; see also section 2.2.1 for HRESULT values predefined by the Disk Management Remote Protocol).