MprConfigTransportCreate 함수(mprapi.h)

MprConfigTransportCreate 함수는 지정된 전송을 지정된 라우터 구성에 있는 전송 프로토콜 목록에 추가합니다.

구문

DWORD MprConfigTransportCreate(
  [in]           HANDLE hMprConfig,
  [in]           DWORD  dwTransportId,
  [in, optional] LPWSTR lpwsTransportName,
  [in]           LPBYTE pGlobalInfo,
  [in]           DWORD  dwGlobalInfoSize,
  [in, optional] LPBYTE pClientInterfaceInfo,
  [in, optional] DWORD  dwClientInterfaceInfoSize,
  [in, optional] LPWSTR lpwsDLLPath,
  [out]          HANDLE *phRouterTransport
);

매개 변수

[in] hMprConfig

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

[in] dwTransportId

구성에 추가할 전송을 설명하는 DWORD 값입니다. 이 매개 변수는 전송에 대한 라우터 관리자도 식별합니다. dwTransportId에 허용되는 값은 다음 표에 나와 있습니다.

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

[in, optional] lpwsTransportName

추가되는 전송의 이름을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 이 매개 변수를 지정하지 않으면 dwTransportId 매개 변수가 문자열로 변환되고 전송 이름으로 사용됩니다.

[in] pGlobalInfo

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

[in] dwGlobalInfoSize

pGlobalInfo 매개 변수가 가리키는 데이터의 크기(바이트)를 지정합니다.

[in, optional] pClientInterfaceInfo

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

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

[in, optional] dwClientInterfaceInfoSize

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

[in, optional] lpwsDLLPath

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

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

[out] phRouterTransport

에 대한 포인터입니다.
dwTransportId 매개 변수에 표시된 전송 구성 핸들 형식을 수신하는 HANDLE 변수입니다.

반환 값

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

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

값	의미
ERROR_INVALID_PARAMETER	hMprConfig 매개 변수가 NULL이거나 phRouterTransport 매개 변수가 NULL이거나 둘 다 NULL입니다.
ERROR_NOT_ENOUGH_MEMORY	작업을 완료할 리소스가 부족합니다.
기타	FormatMessage를 사용하여 반환된 오류 코드에 해당하는 시스템 오류 메시지를 검색합니다.

설명

지정된 전송이 이미 있는 경우 MprConfigTransportCreate 는 제공된 매개 변수 값을 사용하여 MprConfigTransportSetInfo 호출과 동등한 작업을 수행합니다.

요구 사항

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

참고 항목

FormatMessage

MprConfigServerConnect

라우터 구성 함수

라우터 관리 참조