ConnMgrEstablishConnection

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function creates a connection request.

Syntax

HRESULT WINAPI ConnMgrEstablishConnection(
  CONNMGR_CONNECTIONINFO *pConnInfo,
  HANDLE                 *phConnection
);

Parameters

  • pConnInfo
    [in] Pointer to a CONNMGR_CONNECTIONINFO structure that contains the parameters that describe the requested connection.
  • phConnection
    [out] Pointer to a handle to the connection.

Return Values

Returns S_OK if successful or returns an error code if the function call failed.

Remarks

A Windows Mobile application can only have one outstanding connection request at a time. Therefore, once ConnMgrEstabishConnection or ConnMgrEstablishConnectionSync is called, they cannot be called again to create another connection request until the first connection request is released by calling ConnMgrReleaseConnection.

Requirements

Header connmgr.h
Library cellcore.lib
Windows Embedded CE Windows CE .NET 4.2 and later, Windows Embedded NavReady 2009
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

CONNMGR_CONNECTIONINFO
Connection Manager Functions