MediaServerDevice::GetConnectionManager (Windows Embedded CE 6.0)

1/6/2010

This method returns an IConnectionManager pointer that control point code uses to communicate over the network with MediaServer devices.

Syntax

DWORD GetConnectionManager(
  IConnectionManager** ppIConnectionManager,
  wstring* pstrIConnectionManager
);

ppIConnectionManager
Pointer to a pointer to an IConnectionManager implementation that communicates using UPnP with the ConnectionManager service implementation on the specified MediaServer device.

pstrIConnectionManager
Pointer to a string that, upon return, contains the UDN and service ID pair that identifies this ConnectionManager instance. You can use this value in the pszPeerConnectionManager parameter of IConnectionManager::PrepareForConnection.

The following table shows possible return values.

Value	Description
ERROR_AV_POINTER	The ppIConnectionManager parameter is NULL.
ERROR_AV_UPNP_ACTION_FAILED	The internal connection manager proxy implementation could not be initialized.
SUCCESS_AV	The internal connection manager proxy implementation was initialized and returned successfully.

For more information about UPnP AV control points and devices, see UPnP AV DCP Documentation.