Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function maps a URL to the GUIDof 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 DWORDindex variable that can be used to retrieve additional GUIDmappings, if these mappings exist. If this pointer is provided, the DWORDto 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_OKif successful or an error code if the function call failed.

Remarks

This function takes the URL that you specify in pwszURLand 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