MprAdminTransportGetInfo 함수(mprapi.h)

  • 아티클

MprAdminTransportGetInfo 함수는 지정된 전송에 대해 전역 정보, 기본 클라이언트 인터페이스 정보 또는 둘 다를 검색합니다.

구문

DWORD MprAdminTransportGetInfo(
  [in]            MPR_SERVER_HANDLE hMprServer,
  [in]            DWORD             dwTransportId,
  [out, optional] LPBYTE            *ppGlobalInfo,
  [out, optional] LPDWORD           lpdwGlobalInfoSize,
  [out, optional] LPBYTE            *ppClientInterfaceInfo,
  [out, optional] LPDWORD           lpdwClientInterfaceInfoSize
);

매개 변수

[in] hMprServer

정보를 검색할 라우터에 대한 핸들입니다. 이 핸들은 MprAdminServerConnect에 대한 이전 호출에서 가져옵니다.

[in] dwTransportId

검색할 전송 형식을 설명하는 DWORD 값입니다. dwTransportId에 허용되는 값은 다음 표에 나와 있습니다.

값 전송(프로토콜 패밀리)
PID_ATALK Appletalk
PID_IP 인터넷 프로토콜 버전 4
PID_IPX 인터넷 패킷 교환
PID_NBF NetBIOS 프레임 프로토콜
PID_IPV6 Windows Server 2008 이상: 인터넷 프로토콜 버전 6

[out, optional] ppGlobalInfo

포인터 변수에 대한 포인터입니다. 이 변수는 이 전송에 대한 전역 정보를 수신하는 정보 헤더를 가리킵니다. 정보 헤더 함수를 사용하여 정보 헤더를 조작합니다.

MprAdminBufferFree를 호출하여 이 메모리를 해제합니다.

이 매개 변수는 선택적 요소입니다. 호출 애플리케이션이 이 매개 변수에 대해 NULL 을 지정하는 경우 함수는 전역 정보를 검색하지 않습니다.

[out, optional] lpdwGlobalInfoSize

DWORD 변수에 대한 포인터입니다. 이 변수는 전송에 대한 전역 정보의 크기(바이트)를 받습니다.

[out, optional] ppClientInterfaceInfo

포인터 변수에 대한 포인터입니다. 이 변수는 이 전송에 대한 기본 클라이언트 인터페이스 정보를 가리킵니다. MprAdminBufferFree를 호출하여 이 메모리를 해제합니다.

이 매개 변수는 선택적 요소입니다. 호출 애플리케이션이 이 매개 변수에 대해 NULL 을 지정하는 경우 함수는 클라이언트 인터페이스 정보를 검색하지 않습니다.

[out, optional] lpdwClientInterfaceInfoSize

DWORD 변수에 대한 포인터입니다. 이 변수는 클라이언트 인터페이스 정보의 크기(바이트)를 받습니다.

반환 값

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

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

값 의미
ERROR_ACCESS_DENIED
 호출 애플리케이션에 충분한 권한이 없습니다.
ERROR_INVALID_PARAMETER
 다음 중 하나에 해당합니다.
  • ppGlobalInfo 매개 변수와 ppClientInterfaceInfo 매개 변수는 모두 NULL입니다.
  • ppGlobalInfo 매개 변수는 유효한 메모리를 가리키지 않습니다.
  • ppClientInterfaceInfo 매개 변수는 유효한 메모리를 가리키지 않습니다.
ERROR_NOT_ENOUGH_MEMORY
 작업을 완료할 리소스가 부족합니다.
ERROR_UNKNOWN_PROTOCOL_ID
 dwTransportId 값이 설치된 전송과 일치하지 않습니다.

설명

ppGlobalInfo 및 ppClientInterfaceInfo 매개 변수는 둘 다 NULL일 수 없습니다.

요구 사항

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

추가 정보

MprAdminBufferFree

MprAdminServerConnect

MprAdminTransportSetInfo

라우터 관리 함수

라우터 관리 참조