ConnMgrMapURL

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function maps a URL to the GUID of a destination network to which the device is connected.

Syntax

HRESULT WINAPI ConnMgrMapURL(
  LPTSTR   pwszURL,
  GUID     *pguid,
  DWORD    *pdwIndex
); 

Parameters

  • pwszURL
    [in] Specifies the URL to be mapped.
  • pguid
    [out] Pointer to the destination network GUID.
  • pdwIndex
    [in, out] Optional pointer to a DWORD index variable that can be used to retrieve additional GUID mappings, if these mappings exist. If this pointer is provided, the DWORD to which the pointer refers should be initialized to 0 before the first call to ConnMgrMapURL. This variable is updated for each call so that successive calls can start searching the mapping table at the point where the previous call returned.

Return Values

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

Remarks

This function takes the URL that you specify in pwszURL and determines the best network connection to use to access that URL.

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

Connection Manager Functions