MprConfigInterfaceTransportGetInfo 함수(mprapi.h)

아티클
03/15/2023

MprConfigInterfaceTransportGetInfo 함수는 지정된 인터페이스에서 지정된 클라이언트에 대한 구성 정보를 검색합니다.

구문

DWORD MprConfigInterfaceTransportGetInfo(
  [in]                HANDLE  hMprConfig,
  [in]                HANDLE  hRouterInterface,
  [in]                HANDLE  hRouterIfTransport,
  [in, out, optional] LPBYTE  *ppInterfaceInfo,
  [out, optional]     LPDWORD lpdwInterfaceInfoSize
);

매개 변수

[in] hMprConfig

라우터 구성에 대한 핸들입니다. MprConfigServerConnect를 호출하여 이 핸들을 가져옵니다.

[in] hRouterInterface

지정된 클라이언트 정보를 검색할 인터페이스 구성에 대한 핸들입니다. MprConfigInterfaceCreate, MprConfigInterfaceGetHandle 또는 MprConfigInterfaceEnum을 호출하여 이 핸들을 가져옵니다.

[in] hRouterIfTransport

지정된 클라이언트 정보를 검색할 전송 구성에 대한 핸들입니다. MprConfigInterfaceTransportAdd, MprConfigInterfaceTransportGetHandle 또는 MprConfigInterfaceTransportEnum을 호출하여 이 핸들을 가져옵니다. 지원되는 전송 프로토콜 유형은 전송 식별자에 나열됩니다.

[in, out, optional] ppInterfaceInfo

입력 시 포인터 변수에 대한 포인터입니다.

출력에서 이 포인터 변수는 클라이언트에 대한 구성 정보를 포함하는 정보 헤더를 가리킵니다. 정보 헤더 함수를 사용하여 정보 헤더를 조작합니다. MprConfigBufferFree를 호출하여 이 메모리를 해제합니다.

이 매개 변수는 선택 사항입니다. 호출 애플리케이션이 이 매개 변수에 대해 NULL 을 지정하는 경우 함수는 구성 정보를 반환하지 않습니다.

[out, optional] lpdwInterfaceInfoSize

DWORD 변수에 대한 포인터입니다. 이 변수는 ppInterfaceInfo가 가리키는 데이터의 크기(바이트)를 받습니다.

이 매개 변수는 선택 사항입니다. 호출 애플리케이션이 이 매개 변수에 대해 NULL 을 지정할 수 있습니다. 그러나 ppInterfaceInfo 가 NULL이 아닌 경우 이 매개 변수는 NULL일 수 없습니다. 자세한 내용은 이 항목의 뒷부분에 나오는 주의 섹션을 참조하십시오.

반환 값

함수가 성공하면 반환 값이 NO_ERROR. 자세한 내용은 이 항목의 뒷부분에 나오는 주의 섹션을 참조하십시오.

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

값	의미
ERROR_INVALID_PARAMETER	다음 중 하나에 해당합니다. hMprConfig 는 NULL입니다. hRouterInterface 는 NULL입니다. hRouterIfTransport 는 NULL입니다. ppInterfaceInfo 는 NULL이 아니지만 lpdwInterfaceInfoSize 는 NULL입니다.
ERROR_NO_SUCH_INTERFACE	hRouterIfTransport로 지정된 인터페이스가 라우터 구성에서 찾을 수 없거나 지정된 인터페이스에서 hRouterIfTransport로 지정된 전송을 사용할 수 없습니다.
ERROR_NOT_ENOUGH_MEMORY	작업을 완료할 리소스가 부족합니다.
기타	FormatMessage를 사용하여 반환된 오류 코드에 해당하는 시스템 오류 메시지를 검색합니다.

설명

ppInterfaceInfo 매개 변수가 NULL이면 MprConfigInterfaceTransportGetInfo는 아무 작업도 수행하지 않으며 값이 NO_ERROR 즉시 반환됩니다.

요구 사항


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