MprConfigTransportGetInfo 함수(mprapi.h)

아티클
03/15/2023

MprConfigTransportGetInfo 함수는 라우터에서 지정된 전송 프로토콜에 대한 구성을 검색합니다.

구문

DWORD MprConfigTransportGetInfo(
  [in]                HANDLE  hMprConfig,
  [in]                HANDLE  hRouterTransport,
  [in, out, optional] LPBYTE  *ppGlobalInfo,
  [out, optional]     LPDWORD lpdwGlobalInfoSize,
  [in, out, optional] LPBYTE  *ppClientInterfaceInfo,
  [out, optional]     LPDWORD lpdwClientInterfaceInfoSize,
  [in, out, optional] LPWSTR  *lplpwsDLLPath
);

매개 변수

[in] hMprConfig

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

[in] hRouterTransport

검색되는 전송 프로토콜 구성에 대한 핸들입니다. MprConfigTransportCreate, MprConfigTransportGetHandle 또는 MprConfigTransportEnum을 호출하여 이 핸들을 가져옵니다. 지원되는 전송 프로토콜 유형은 전송 식별자에 나열됩니다.

[in, out, optional] ppGlobalInfo

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

출력에서 이 포인터 변수는 전송에 대한 전역 정보가 포함된 정보 헤더를 가리킵니다. 정보 헤더 함수를 사용하여 정보 헤더를 조작합니다. MprConfigBufferFree를 호출하여 이 버퍼를 해제합니다.

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

[out, optional] lpdwGlobalInfoSize

DWORD 변수에 대한 포인터입니다. 이 변수는 ppGlobalInfo 매개 변수를 통해 반환된 버퍼의 크기(바이트)를 받습니다.

이 매개 변수는 선택 사항입니다. 호출 애플리케이션이 이 매개 변수에 대해 NULL 을 지정할 수 있습니다. 그러나 ppGlobalInfo 가 NULL이 아닌 경우 이 매개 변수는 NULL일 수 없습니다.

[in, out, optional] ppClientInterfaceInfo

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

출력에서 이 포인터는 이 전송에 대한 클라이언트 라우터에 대한 기본 인터페이스 정보를 포함하는 정보 헤더를 가리킵니다. 정보 헤더 함수를 사용하여 정보 헤더를 조작합니다. MprConfigBufferFree를 호출하여 버퍼를 해제합니다.

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

[out, optional] lpdwClientInterfaceInfoSize

DWORD 변수에 대한 포인터입니다. 이 변수는 ppClientInterfaceInfo 매개 변수를 통해 반환된 버퍼의 크기(바이트)를 받습니다.

이 매개 변수는 선택 사항입니다. 호출 애플리케이션이 이 매개 변수에 대해 NULL 을 지정할 수 있습니다. 그러나 ppClientInterfaceInfo 가 NULL이 아닌 경우 이 매개 변수는 NULL일 수 없습니다.

[in, out, optional] lplpwsDLLPath

입력에서 null로 끝나는 유니코드 문자열에 대한 포인터에 대한 포인터입니다.

출력 시 유니코드 문자열은 지정된 전송에 대한 라우터 관리자 DLL의 이름을 받습니다.

이 매개 변수는 선택 사항입니다. 호출 애플리케이션이 이 매개 변수에 대해 NULL 을 지정하는 경우 함수는 라우터 관리자 DLL의 이름을 검색하지 않습니다.

반환 값

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

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

값	의미
ERROR_INVALID_PARAMETER	다음 중 적어도 하나가 참입니다. hMprConfig 가 NULL입니다. hRouterTransport 는 NULL입니다. ppGlobalInfo 는 NULL이 아니지만 lpdwGlobalInfoSize 는 NULL입니다. ppClientInterfaceInfo 는 NULL이 아니지만 lpdwClientInterfaceInfo 는 NULL입니다.
ERROR_UNKNOWN_PROTOCOL_ID	hRouterTransport에 해당하는 전송 프로토콜 구성을 라우터 구성에서 찾을 수 없습니다.
ERROR_NOT_ENOUGH_MEMORY	작업을 완료할 리소스가 부족합니다.
기타	FormatMessage를 사용하여 반환된 오류 코드에 해당하는 시스템 오류 메시지를 검색합니다.

설명

pGlobalInfo, pClientInterfaceInfo 및 lpwsDLLPath 매개 변수가 모두 NULL이면 함수는 아무 작업도 수행하지 않으며 NO_ERROR 값을 반환합니다.

요구 사항


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