IConnectionManager::GetCurrentConnectionInfo (Windows Embedded CE 6.0)

1/6/2010

This method returns information about the specified connection.

Syntax

virtual DWORD GetCurrentConnectionInfo(
  long ConnectionID,
  ConnectionInfo* pConnectionInfo
) = 0;

Parameters

• ConnectionID
  [in] ID of the connection about which information should be retrieved. You can retrieve connection IDs using IConnectionManager::GetFirstConnectionID and IConnectionManager::GetNextConnectionID.

• pConnectionInfo
  [in, out] Pointer to a ConnectionInfo structure.

Return Value

Custom implementations can return appropriate error codes. Should return SUCCESS_AV if the method succeeds. Otherwise, should return an error code defined in WinError.h or UPnP.h, or one of the UPnP AV-specific return values specified in UPnPAVError, especially the following error documented for this action in the ConnectionManager DCP documentation:

• ERROR_AV_UPNP_ACTION_FAILED

The implementation of this method in IConnectionManagerImpl returns these errors:

Remarks

The AVTransport service's PrepareForConnection action is defined as optional in the UPnP AV DCP. The AV renderer sample implements PrepareForConnection, or does not, depending on the value of the CM_NO_PREPARE_FOR_CONNECTION preprocessor definition. If this constant is defined, the sample does not support PrepareForConnection; otherwise, the sample provides support for multiple connections. To see how this definition is used, examine ConnectionManager.cpp in the AV renderer sample's source directory.

Requirements

See Also

Reference

IConnectionManager
IConnectionManager::GetFirstConnectionID
IConnectionManager::GetNextConnectionID
IVirtualService::Release
ConnectionInfo