MprConfigInterfaceTransportSetInfo 함수(mprapi.h)

아티클
08/24/2023

MprConfigInterfaceTransportSetInfo 함수는 지정된 인터페이스 및 전송 프로토콜에서 클라이언트에 대한 구성 정보를 업데이트합니다.

구문

DWORD MprConfigInterfaceTransportSetInfo(
  [in]           HANDLE hMprConfig,
  [in]           HANDLE hRouterInterface,
  [in]           HANDLE hRouterIfTransport,
  [in, optional] LPBYTE pInterfaceInfo,
  [in, optional] DWORD  dwInterfaceInfoSize
);

매개 변수

[in] hMprConfig

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

[in] hRouterInterface

정보를 업데이트할 인터페이스 구성에 대한 핸들입니다. MprConfigInterfaceCreate 또는 MprConfigInterfaceEnum을 호출하여 이 핸들을 가져옵니다.

[in] hRouterIfTransport

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

[in, optional] pInterfaceInfo

지정된 인터페이스 및 전송에서 클라이언트에 대한 구성 정보를 포함하는 정보 헤더에 대한 포인터입니다. 지정된 전송에 대한 라우터 관리자는 이 정보를 해석합니다. 정보 헤더 함수를 사용하여 정보 헤더를 조작합니다.

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

[in, optional] dwInterfaceInfoSize

pInterfaceInfo가 가리키는 데이터의 크기(바이트)를 지정합니다.

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

반환 값

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

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

값	의미
ERROR_INVALID_PARAMETER	다음 중 적어도 하나가 참입니다. hMprConfig 는 NULL입니다. hRouterInterface 는 NULL입니다. hRouterIfTransport 는 NULL입니다.
ERROR_NO_SUCH_INTERFACE	hRouterInterface로 지정된 인터페이스가 라우터 구성에 더 이상 없거나 hRouterInterface로 지정된 전송이 인터페이스에 더 이상 존재하지 않습니다.
기타	FormatMessage를 사용하여 반환된 오류 코드에 해당하는 시스템 오류 메시지를 검색합니다.

설명

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

요구 사항


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