ConnMgrMapURL

The ConnMgrMapURL function maps a URL to the globally unique identifier (GUID) of the network to which the device is connected.

Syntax

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

Parameters

  • pwszURL
    The URL to be mapped.
  • pguid
    Pointer to the destination network GUID.
  • pdwIndex
    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

None.

Remarks

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

Requirements

Smartphone: Windows Mobile 2002 and later
OS Versions: Windows CE 3.0 and later
Header: connmgr.h
Library: cellcore.lib

See Also

Connection Manager

Connection Manager API Functions

Last updated on Friday, April 22, 2005

© 2005 Microsoft Corporation. All rights reserved.

Send feedback on this topic to the authors.