GetAdapterIndex 함수(iphlpapi.h)

아티클
03/05/2024

GetAdapterIndex 함수는 이름이 지정된 어댑터의 인덱스를 가져옵니다.

구문

IPHLPAPI_DLL_LINKAGE DWORD GetAdapterIndex(
  [in]      LPWSTR AdapterName,
  [in, out] PULONG IfIndex
);

매개 변수

[in] AdapterName

어댑터의 이름을 지정하는 유니코드 문자열에 대한 포인터입니다.

[in, out] IfIndex

어댑터의 인덱스 를 가리키는 ULONG 변수에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값이 NO_ERROR.

함수가 실패하면 FormatMessage를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다.

설명

어댑터가 완전히 비활성화될 때까지 GetAdapterIndex 함수는 어댑터를 현재 상태로 보고합니다. 예를 들어 NotifyAddrChange 함수는 최근에 사용하지 않도록 설정된 어댑터의 IP 주소가 제거되었음을 나타낼 수 있지만 GetAdapterIndex 는 어댑터를 사용하지 않도록 설정하는 프로세스가 완료될 때까지 어댑터 인덱스를 계속 보고합니다.

시스템에 하나 이상의 어댑터가 있으면 쿼리 중인 어댑터가 없으면 GetAdapterIndex 가 ERROR_DEV_NOT_EXIST 반환합니다. 어댑터가 없으면 GetAdapterIndex 함수는 ERROR_NO_DATA 반환합니다.

어댑터가 비활성화된 후 사용하도록 설정되거나 다른 상황에서 어댑터 인덱스가 변경될 수 있으며 영구로 간주해서는 안 됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	iphlpapi.h
라이브러리	Iphlpapi.lib
DLL	Iphlpapi.dll