This function maps a URL to the GUID of a destination network to which the device is connected.
HRESULT WINAPI ConnMgrMapURL( LPTSTR pwszURL, GUID *pguid, DWORD *pdwIndex );
[in] Specifies the URL to be mapped.
[out] Pointer to the destination network GUID.
[in] 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.
Returns S_OK if successful or an error code if the function call failed.
This function takes the URL that you specify in pwszURL and determines the best network connection to use to access that URL.