Edit

Share via


OnDemandGetRoutingHint function (ondemandconnroutehelper.h)

The OnDemandGetRoutingHint function looks up a destination in the Route Request cache and, if a match is found, return the corresponding Interface ID.

Syntax

HRESULT OnDemandGetRoutingHint(
  [in]  PCWSTR destinationHostName,
  [out] DWORD  *interfaceIndex
);

Parameters

[in] destinationHostName

An PWSTR describing the target host name for a network communication.

[out] interfaceIndex

The interface index of the network adapter to be used for communicating with the target host.

Return value

This function returns the following to indicate operation results:

Return code Description
S_OK
A match was found in the dll cache. The pdwInterfaceIndex will contain the index of the interface to be used to communicate with the target host.
S_FALSE
A match was not found in the dll cache for the specified host name.

Requirements

Requirement Value
Minimum supported client Windows 8.1 [desktop apps only]
Minimum supported server Windows Server 2012 R2 [desktop apps only]
Target Platform Windows
Header ondemandconnroutehelper.h
Library OnDemandConnRouteHelper.lib
DLL OnDemandConnRouteHelper.dll