IMarshal::DisconnectObject

Severs remote connections (that is, connections from other processes) being maintained on behalf of any interface pointers on the current object.

HRESULT IMarshal::DisconnectObject(

DWORD dwReserved	//Reserved for future use
);

Parameter
dwReserved

[in] Reserved for future use; must be set to zero by the caller. To ensure compatibility with future use, the callee must not check for zero.

Return Values
S_OK

The object was disconnected successfully.

E_FAIL

Indicates an unspecified error.

E_OUTOFMEMORY

Out of memory.

E_INVALIDARG

One or more arguments were invalid.

E_UNEXPECTED

An unexpected error occured.

Comments
This method is called from the originating side (that is, the side doing the marshaling).

This method is called by the CoDisconnectObject API function if the object being disconnected implements the IMarshal interface. This is analogous to the way the CoMarshalInterface API function defers to the IMarshal::MarshalInterface method if the object supports IMarshal.

Notes to Implementors
If you are doing custom marshaling of immutable objects, your implementation doesn't need to do anything because there are no remote connections.