다음을 통해 공유

GetPerAdapterInfo 함수(iphlpapi.h)

  • 아티클

GetPerAdapterInfo 함수는 지정된 인터페이스에 해당하는 어댑터에 대한 정보를 검색합니다.

구문

IPHLPAPI_DLL_LINKAGE DWORD GetPerAdapterInfo(
  [in]  ULONG                IfIndex,
  [out] PIP_PER_ADAPTER_INFO pPerAdapterInfo,
  [in]  PULONG               pOutBufLen
);

매개 변수

[in] IfIndex

인터페이스의 인덱스입니다. GetPerAdapterInfo 함수는 이 인터페이스에 해당하는 어댑터에 대한 정보를 검색합니다.

[out] pPerAdapterInfo

어댑터에 대한 정보를 수신하는 IP_PER_ADAPTER_INFO 구조체에 대한 포인터입니다.

[in] pOutBufLen

IP_PER_ADAPTER_INFO 구조체의 크기를 지정하는 ULONG 변수에 대한 포인터입니다. 이 크기가 정보를 보유하기에 충분하지 않은 경우 GetPerAdapterInfo 는 이 변수를 필요한 크기로 채우고 ERROR_BUFFER_OVERFLOW 오류 코드를 반환합니다.

반환 값

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

함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.

반환 코드 설명
ERROR_BUFFER_OVERFLOW
 pOutBufLen 매개 변수로 표시된 버퍼 크기가 너무 작아 어댑터 정보를 보유할 수 없습니다. pOutBufLen 매개 변수는 필요한 크기를 가리킵니다.
ERROR_INVALID_PARAMETER
 pOutBufLen 매개 변수가 NULL이거나 호출 프로세스에 pOutBufLen이 가리키는 메모리에 대한 읽기/쓰기 액세스 권한이 없거나 호출 프로세스에 pAdapterInfo 매개 변수가 가리키는 메모리에 대한 쓰기 권한이 없습니다.
ERROR_NOT_SUPPORTED

GetPerAdapterInfo 는 로컬 컴퓨터에서 실행되는 운영 체제에서 지원되지 않습니다.
기타
 함수가 실패하면 FormatMessage를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다.
 
 

설명

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

요구 사항

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

추가 정보

IP 도우미 함수 참조

IP 도우미 시작 페이지

IP_PER_ADAPTER_INFO