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.
함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.
| 반환 코드 | 설명 |
|---|---|
|
pOutBufLen 매개 변수로 표시된 버퍼 크기가 너무 작아 어댑터 정보를 보유할 수 없습니다. pOutBufLen 매개 변수는 필요한 크기를 가리킵니다. |
|
pOutBufLen 매개 변수가 NULL이거나 호출 프로세스에 pOutBufLen이 가리키는 메모리에 대한 읽기/쓰기 액세스 권한이 없거나 호출 프로세스에 pAdapterInfo 매개 변수가 가리키는 메모리에 대한 쓰기 권한이 없습니다. |
|
GetPerAdapterInfo 는 로컬 컴퓨터에서 실행되는 운영 체제에서 지원되지 않습니다. |
|
함수가 실패하면 FormatMessage를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다. |
설명
어댑터가 비활성화된 후 사용하도록 설정되거나 다른 상황에서 어댑터 인덱스가 변경될 수 있으며 영구로 간주해서는 안 됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | iphlpapi.h |
| 라이브러리 | Iphlpapi.lib |
| DLL | Iphlpapi.dll |