GetInterfaceContextTableForHostName 함수(ondemandconnroutehelper.h)

이 함수는 지정된 호스트 이름 및 연결 프로필 필터에 대한 인터페이스 컨텍스트 테이블을 검색합니다.

구문

HRESULT GetInterfaceContextTableForHostName(
  [in, optional] PCWSTR                      HostName,
  [in, optional] PCWSTR                      ProxyName,
  [in]           DWORD                       Flags,
  [in, optional] BYTE                        *ConnectionProfileFilterRawData,
  [in]           DWORD                       ConnectionProfileFilterRawDataSize,
  [out]          NET_INTERFACE_CONTEXT_TABLE **InterfaceContextTable
);

매개 변수

[in, optional] HostName

대상 호스트 이름입니다.

[in, optional] ProxyName

HTTP 프록시 이름입니다.

[in] Flags

다음 플래그를 사용할 수 있습니다.

 

플래그	설명
NET_INTERFACE_FLAG_NONE	기본 동작을 사용합니다.
NET_INTERFACE_FLAG_CONNECT_IF_NEEDED	기본 연결을 활성화할지 여부를 나타냅니다.

[in, optional] ConnectionProfileFilterRawData

wcm_selection_filters 바이트 캐스트인 연결 프로필 필터 블로그입니다.

[in] ConnectionProfileFilterRawDataSize

ConnectionProfileFilterRawData의 크기(바이트)입니다.

[out] InterfaceContextTable

호스트 이름 및 필터에 사용할 수 있는 인터페이스 인덱스 및 구성 이름을 포함하는 NET_INTERFACE_CONTEXT 구조 목록으로 설정됩니다.

반환 값

이 함수는 상태 따라 다음 HRESULT 값을 반환합니다.

 

HRESULT	설명
S_OK	매개 변수 및 내부 정책을 충족하는 연결이 있는 경우 반환됩니다. NET_INTERFACE_CONTEXT_TABLE 인터페이스 인덱스 목록과 해당 연결의 구성 이름을 포함합니다. S_OK 반환되면 컨텍스트 테이블을 해제하려면 FreeInterfaceContextTable 을 호출해야 합니다.
S_FALSE	이 호스트 이름 및 필터에 연결 또는 기본 인터페이스를 사용할 수 있음을 나타내기 위해 반환됩니다. 이 경우 호출자가 기본 경로를 사용하여 요구 사항을 충족할 수 있으므로 NET_INTERFACE_CONTEXT_TABLE null이 됩니다.
E_NOTFOUND	현재 사용할 수 있는 연결이 없거나 기존 연결이 호스트에 대한 연결 필터 및 내부 정책을 충족하지 않는 경우 반환됩니다. 정확한 반환 코드는 HRESULT(ERROR_NOT_FOUND)입니다.
E_INVALIDARG	호출자가 잘못된 인수를 전달하고, 지원되지 않는 플래그를 사용하고, 잘못된 연결 필터 데이터, 잘못된 크기 또는 null NET_INTERFACE_CONTEXT_TABLE
E_OUTOFMEMORY	작업을 완료하는 데 충분한 메모리가 없는 경우 반환됩니다.
FAILED(HRESULT)	이 함수가 제어할 수 없는 오류로 인해 반환됩니다.

요구 사항

지원되는 최소 클라이언트	Windows 10 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	ondemandconnroutehelper.h
라이브러리	OnDemandConnRouteHelper.lib
DLL	OnDemandConnRouteHelper.dll

추가 정보

FreeInterfaceContextTable

NET_INTERFACE_CONTEXT_TABLE