CoDisconnectObject 12WTF_O

Disconnects all remote process connections being maintained on behalf of all the interface pointers that point to a specified object. Only the process that actually manages the object should call CoDisconnectObject.

STDAPI CoDisconnectObject(

IUnknown * pUnk,	//Pointer to the interface on the object
DWORD dwReserved	//Reserved for future use
);

Parameters

pUnk

[in] Pointer to any IUnknown1NEM0LU-derived interface on the object to be disconnected.

dwReserved

[in] Reserved for future use; must be zero.

Return Values

S_OK

All connections to remote processes were successfully deleted.

Remarks

The CoDisconnectObject function enables a server to correctly disconnect all external clients to the object specified by pUnk.

The CoDisconnectObject function performs the following tasks:

1. Checks to see if the object to be disconnected implements the IMarshal interface. If so, it gets the pointer to that interface; if not, it gets a pointer to the standard marshaler s (i.e., COM s) IMarshal implementation.

2. Using whichever IMarshal interface pointer it has acquired, the function then calls IMarshal::DisconnectObject1VIIBC to disconnect all out-of-process clients.

An object s client does not call CoDisconnectObject to disconnect itself from the server (clients should use IUnknown::ReleaseDUW01A for this purpose). Rather, an OLE server calls CoDisconnectObject to forcibly disconnect an object s clients, usually in response to a user closing the server application.

Similarly, an OLE container that supports external links to its embedded objects can call CoDisconnectObject to destroy those links. Again, this call is normally made in response to a user closing the application. The container should first call IOleObject::Close for all its OLE objects, each of which should send IAdviseSink::OnClose notifications to their various clients. Then the container can safely call CoDisconnectObject to close any existing connections.