INetworkCostManager::GetDataPlanStatus 메서드(netlistmgr.h)

  • 아티클

GetDataPlanStatus는 컴퓨터 전체 인터넷 연결 또는 연결에서 특정 대상으로 라우팅하는 첫 번째 홉에 대한 데이터 요금제 상태 검색합니다. IPv4/IPv6 주소를 지정하지 않으면 이 메서드는 컴퓨터 전체 인터넷 연결에 사용되는 연결의 데이터 요금제 상태 반환합니다.

구문

HRESULT GetDataPlanStatus(
  [out] NLM_DATAPLAN_STATUS *pDataPlanStatus,
  [in]  NLM_SOCKADDR        *pDestIPAddr
);

매개 변수

[out] pDataPlanStatus

대상으로 라우팅하는 데 사용되는 연결과 연결된 데이터 계획 상태 설명하는 NLM_DATAPLAN_STATUS 구조체에 대한 포인터입니다. destIPAddr가 터널 주소를 지정하는 경우 인터페이스 스택에서 상태 사용 가능한 첫 번째 데이터 요금제가 반환됩니다.

[in] pDestIPAddr

대상 IPv4/IPv6 또는 터널 주소를 포함하는 NLM_SOCKADDR 구조체입니다. NULL인 경우 이 메서드는 컴퓨터 인터넷 연결에 사용되는 기본 설정 연결과 관련된 비용을 반환합니다.

반환 값

성공 시 S_OK 반환하고, 그렇지 않으면 HRESULT 오류 코드가 반환됩니다.

반환 코드 설명
E_POINTER
 pDataPlanStatus 는 NULL입니다.
E_PENDING
 대상으로 라우팅하는 데 사용되는 인터페이스 결정
E_INVALIDARG
 destIPAddr로 지정된 대상 주소가 잘못되었습니다.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 요청이 지원되지 않습니다. 이 오류는 IPv4 또는 IPv6 스택이 로컬 컴퓨터에 없지만 destIPAddr에서 IPv4 또는 IPv6 주소를 지정한 경우 반환됩니다.
HRESULT_FROM_WIN32(ERROR_NO_NETWORK)
 네트워크 연결을 현재 사용할 수 없습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버 지원되는 버전 없음
대상 플랫폼 Windows
헤더 netlistmgr.h

추가 정보

INetworkCostManager

NLM_SOCKADDR