MprAdminInterfaceCreate 함수(mprapi.h)

아티클
08/24/2023

MprAdminInterfaceCreate 함수는 지정된 서버에 인터페이스를 만듭니다.

구문

DWORD MprAdminInterfaceCreate(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [in]  LPBYTE            lpbBuffer,
  [out] HANDLE            *phInterface
);

매개 변수

[in] hMprServer

이 호출을 실행할 라우터에 대한 핸들입니다. MprAdminServerConnect를 호출하여 이 핸들을 가져옵니다.

[in] dwLevel

lpBuffer 매개 변수에서 정보가 구조화된 형식을 설명하는 DWORD 값입니다. 다음 표에 나열된 대로 dwLevel 에 허용되는 값에는 0, 1, 2 및 3이 포함됩니다.

값	구조체 형식
0	MPR_INTERFACE_0
1	MPR_INTERFACE_1
2	MPR_INTERFACE_2
3	Windows Server 2008 이상: MPR_INTERFACE_3

[in] lpbBuffer

MPR_INTERFACE_1 MPR_INTERFACE_0 대한 포인터
MPR_INTERFACE_2 또는 MPR_INTERFACE_3 구조체입니다. dwLevel 매개 변수는 구조체의 형식을 나타냅니다.

[out] phInterface

HANDLE 변수에 대한 포인터입니다. 변수는 이 인터페이스를 관리하기 위해 모든 후속 호출에 사용할 핸들을 받습니다.

반환 값

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

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

값	의미
ERROR_ACCESS_DENIED	호출 애플리케이션에 충분한 권한이 없습니다.
ERROR_DDM_NOT_RUNNING	동적 인터페이스 관리자가 LAN에서만 실행되도록 구성되어 있으므로 라우터 인터페이스 형식은 지원되지 않습니다.
ERROR_INTERFACE_ALREADY_EXISTS	이름이 같은 인터페이스가 이미 있습니다.
ERROR_NOT_ENOUGH_MEMORY	작업을 완료할 리소스가 부족합니다.
ERROR_NOT_SUPPORTED	dwLevel 값이 잘못되었습니다.

설명

MprAdminInterfaceCreate 함수는 MPR_INTERFACE_2 구조를 지원합니다. 그러나 MprConfigInterfaceCreate 는 그렇지 않습니다. 다시 부팅 후 지속되는 요청 다이얼 인터페이스를 만들려면 MPR_INTERFACE_2 사용하여 MprAdminInterfaceCreate를 호출한 다음, MPR_INTERFACE_0또는 MPR_INTERFACE_1 사용하여 MprConfigInterfaceCreate를 호출합니다.

요구 사항


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