MprConfigTransportSetInfo 함수(mprapi.h)

아티클
02/29/2024

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

구문

DWORD MprConfigTransportSetInfo(
  [in]           HANDLE hMprConfig,
  [in]           HANDLE hRouterTransport,
  [in, optional] LPBYTE pGlobalInfo,
  [in, optional] DWORD  dwGlobalInfoSize,
  [in, optional] LPBYTE pClientInterfaceInfo,
  [in, optional] DWORD  dwClientInterfaceInfoSize,
  [in, optional] LPWSTR lpwsDLLPath
);

매개 변수

[in] hMprConfig

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

[in] hRouterTransport

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

[in, optional] pGlobalInfo

전송 프로토콜에 대한 전역 정보를 지정하는 정보 헤더에 대한 포인터입니다. 전송의 라우터 관리자는 이 정보를 해석합니다. 정보 헤더 함수를 사용하여 정보 헤더를 조작합니다.

이 매개 변수는 선택 사항입니다. 호출 애플리케이션이 이 매개 변수에 대해 NULL 을 지정할 수 있습니다.

[in, optional] dwGlobalInfoSize

pGlobalInfo가 가리키는 데이터의 크기(바이트)를 지정합니다. 호출 애플리케이션이 pGlobalInfo에 대해 NULL을 지정하는 경우 호출 애플리케이션은 이 매개 변수에 대해 0을 지정해야 합니다.

[in, optional] pClientInterfaceInfo

클라이언트 라우터에 대한 기본 인터페이스 정보를 지정하는 정보 헤더에 대한 포인터입니다. 이 정보는 이 전송에 대한 클라이언트 라우터에 대한 동적 인터페이스를 구성하는 데 사용됩니다. 정보 헤더 함수를 사용하여 정보 헤더를 조작합니다.

이 매개 변수는 선택 사항입니다. 호출 애플리케이션이 이 매개 변수에 대해 NULL 을 지정할 수 있습니다.

[in, optional] dwClientInterfaceInfoSize

pClientInterfaceInfo가 가리키는 데이터의 크기(바이트)를 지정합니다. 호출하는 애플리케이션이 pClientInterfaceInfo에 대해 NULL을 지정하는 경우 호출 애플리케이션은 이 매개 변수에 대해 0을 지정해야 합니다.

[in, optional] lpwsDLLPath

지정된 전송에 대한 라우터 관리자 DLL의 이름을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

이 매개 변수는 선택 사항입니다. 호출 애플리케이션이 이 매개 변수에 대해 NULL 을 지정할 수 있습니다.

반환 값

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

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

값	의미
ERROR_INVALID_PARAMETER	hMprConfig 매개 변수는 NULL, hRouterTransport 매개 변수는 NULL이거나 둘 다 NULL입니다.
ERROR_UNKNOWN_PROTOCOL_ID	hRouterTransport에 해당하는 전송 프로토콜 구성을 라우터 구성에서 찾을 수 없습니다.
기타	FormatMessage를 사용하여 반환된 오류 코드에 해당하는 시스템 오류 메시지를 검색합니다.

설명

MprConfigTransportSetInfo를 사용하여 전송의 전역 정보, 기본 인터페이스 정보 또는 전송에 대한 라우터 관리자 DLL의 이름을 설정합니다.

MprConfigTransportSetInfo 는 매개 변수 목록에 표시되는 순서대로 항목을 설정하려고 시도합니다.

전역 정보.
클라이언트 라우터에 대한 기본 인터페이스 정보입니다.
라우터 관리자 DLL 이름입니다.

MprConfigTransportSetInfo가 항목 중 하나를 설정할 수 없는 경우 나머지 항목을 설정하지 않고 즉시 반환됩니다.

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

요구 사항

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