IConnectionManager::GetFirstConnectionID (Windows CE 5.0)
This method starts an iteration through the connection IDs for connections managed by this ConnectionManager instance, and returns the first connection ID. To retrieve the remainder of the connection IDs managed by this instance, use IConnectionManager::GetNextConnectionID.
virtual DWORD GetFirstConnectionID( long* pConnectionID) = 0;
Parameters
- pConnectionID
[in, out] Pointer to an integer allocated by the caller that this method modifies to contain the first connection ID. Does not correspond directly to a state variable because of use of an iterator model with GetNextConnectionID. Related to the CurrentConnectionIDs state variable.
Return Values
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.
The implementation of this method in IConnectionManagerImpl returns these errors:
| Value | Description |
|---|---|
| ERROR_AV_POINTER | The pConnectionID pointer is NULL. |
| ERROR_AV_NO_MORE_ITEMS | There are no connection IDs to return. |
| SUCCESS_AV | The iterator was created successfully and the first connection ID was returned. |
Remarks
This method and GetNextConnectionID combined correspond to the ConnectionManager service's GetCurrentConnectionIDs action.
For more information about the actions in the ConnectionManager service, see UPnP AV DCP Documentation.
Requirements
OS Versions: Windows CE 5.0 and later.
Header: Av_upnp.h.
Link Library: Av_upnp.lib.
C++ Namespace: av_upnp.
See Also
IConnectionManager | IConnectionManager::GetNextConnectionID | IConnectionManagerImpl | UPnPAVError
Send Feedback on this topic to the authors