MprAdminInterfaceTransportGetInfo 함수(mprapi.h)
MprAdminInterfaceTransportGetInfo 함수는 지정된 인터페이스에서 실행되는 전송에 대한 정보를 검색합니다.
구문
DWORD MprAdminInterfaceTransportGetInfo(
[in] MPR_SERVER_HANDLE hMprServer,
[in] HANDLE hInterface,
[in] DWORD dwTransportId,
[out] LPBYTE *ppInterfaceInfo,
[out, optional] LPDWORD lpdwInterfaceInfoSize
);
매개 변수
[in] hMprServer
정보를 검색할 라우터에 대한 핸들입니다. MprAdminServerConnect를 호출하여 이 핸들을 가져옵니다.
[in] hInterface
인터페이스에 대한 핸들입니다. 이 핸들은 MprAdminInterfaceCreate에 대한 이전 호출에서 가져옵니다.
[in] dwTransportId
정보가 요청되는 전송을 설명하는 DWORD 값입니다. dwTransportId에 허용되는 값은 다음 표에 나와 있습니다.
| 값 | 전송(프로토콜 패밀리) |
|---|---|
| PID_ATALK | Appletalk |
| PID_IP | 인터넷 프로토콜 버전 4 |
| PID_IPX | 인터넷 패킷 교환 |
| PID_NBF | NetBIOS 프레임 프로토콜 |
| PID_IPV6 | Windows Server 2008 이상: 인터넷 프로토콜 버전 6 |
[out] ppInterfaceInfo
포인터 변수에 대한 포인터입니다. 포인터 변수는 지정된 인터페이스 및 전송에 대한 정보를 수신하는 정보 헤더를 가리킵니다. 정보 헤더 함수를 사용하여 정보 헤더를 조작합니다. MprAdminBufferFree를 호출하여 이 메모리를 해제합니다.
[out, optional] lpdwInterfaceInfoSize
DWORD 변수에 대한 포인터입니다. 이 변수는 ppInterfaceInfo 매개 변수를 통해 반환된 인터페이스 정보의 크기(바이트)를 받습니다.
이 매개 변수는 선택 사항입니다. 호출 애플리케이션이 이 매개 변수에 대해 NULL 을 지정하는 경우 함수는 인터페이스 정보의 크기를 반환하지 않습니다.
반환 값
함수가 성공하면 반환 값이 NO_ERROR.
함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.
| 값 | 의미 |
|---|---|
|
호출 애플리케이션에는 충분한 권한이 없습니다. |
|
hInterface 값이 잘못되었거나 지정된 인터페이스가 관리적으로 사용하지 않도록 설정된 경우 입니다. |
|
지정된 전송이 지정된 인터페이스에서 실행되고 있지 않습니다. |
|
작업을 완료할 리소스가 부족합니다. |
|
dwTransportId 값이 지원되는 전송과 일치하지 않습니다. |
요구 사항
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | mprapi.h |
| 라이브러리 | Mprapi.lib |
| DLL | Mprapi.dll |