MprAdminInterfaceSetCustomInfoEx 함수(mprapi.h)

  • 아티클

지정된 서버의 지정된 수요 다이얼 인터페이스에 대한 터널별 사용자 지정 구성을 설정합니다.

구문

DWORD MprAdminInterfaceSetCustomInfoEx(
  [in] MPR_SERVER_HANDLE    hMprServer,
  [in] HANDLE               hInterface,
  [in] PMPR_IF_CUSTOMINFOEX pCustomInfo
);

매개 변수

[in] hMprServer

쿼리할 라우터에 대한 핸들입니다. 이 핸들은 MprAdminServerConnect 함수에 대한 이전 호출을 통해 가져옵니다.

[in] hInterface

인터페이스에 대한 핸들입니다. 이 핸들은 MprAdminInterfaceCreate 함수 또는 MprAdminInterfaceGetHandle 함수에 대한 이전 호출을 통해 가져옵니다.

[in] pCustomInfo

터널별 사용자 지정 구성을 포함하는 MPR_IF_CUSTOMINFOEX 구조체에 대한 포인터입니다.

반환 값

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

반환 코드 설명
ERROR_ACCESS_DENIED
 호출 애플리케이션에 충분한 권한이 없습니다.
ERROR_INVALID_HANDLE
 hInterface 값이 잘못되었습니다.
ERROR_INVALID_PARAMETER
 pCustomInfo 매개 변수가 NULL이거나 인터페이스 형식이 ROUTER_IF_TYPE_FULL_ROUTER 않습니다.
ERROR_NOT_ENOUGH_MEMORY
 작업을 완료할 수 있는 리소스가 부족했습니다.

설명

인터페이스의 IKEv2 터널에 대한 사용자 지정 구성을 삭제해야 하는 경우 MPR_IF_CUSTOMINFOEX 구조체의 dwFlags 멤버가 0으로 설정된 MprAdminInterfaceSetCustomInfoEx 함수를 호출합니다.

인터페이스에 대한 IKEv2 기본 모드 및 빠른 모드 정책 구성을 삭제해야 하는 경우 MPR_IF_CUSTOMINFOEX 구조에서 customIkev2Config 멤버의 customPolicy 매개 변수를 NULL로 설정합니다.

IKEv2 기본 모드 SA 협상 중에 사용하도록 구성된 인증서를 삭제해야 하는 경우 MPR_IF_CUSTOMINFOEX 구조체의 customIkev2Config 멤버에서 certificateName의 cbData 멤버를 0으로 설정합니다.

요구 사항

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

추가 정보

라우터 관리 함수

라우터 관리 참조