MprConfigInterfaceGetInfo 함수(mprapi.h)

아티클
08/24/2023

MprConfigInterfaceGetInfo 함수는 라우터에서 지정된 인터페이스에 대한 구성을 검색합니다.

구문

DWORD MprConfigInterfaceGetInfo(
  [in]      HANDLE  hMprConfig,
  [in]      HANDLE  hRouterInterface,
  [in]      DWORD   dwLevel,
  [in, out] LPBYTE  *lplpBuffer,
  [out]     LPDWORD lpdwBufferSize
);

매개 변수

[in] hMprConfig

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

[in] hRouterInterface

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

[in] dwLevel

lplpBuffer 매개 변수에서 정보가 반환되는 형식을 설명하는 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, out] lplpBuffer

입력에서 NULL 이 아닌 포인터입니다.

성공적으로 완료되면 MPR_INTERFACE_0 배열에 대한 포인터가 MPR_INTERFACE_1
MPR_INTERFACE_2 또는 MPR_INTERFACE_3 구조체입니다. dwLevel 매개 변수는 구조체의 형식을 나타냅니다. MprConfigBufferFree를 호출하여 이 버퍼를 해제합니다.

[out] lpdwBufferSize

DWORD 변수에 대한 포인터입니다. 이 변수는 lplpBuffer를 통해 반환된 데이터의 크기(바이트)를 받습니다.

반환 값

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

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

값	의미
ERROR_INVALID_PARAMETER	다음 중 적어도 하나가 참입니다. hMprConfig 가 NULL입니다. hRouterInterface 는 NULL입니다. dwLevel 은 0, 1, 2 또는 3이 아닙니다. lplpBuffer 가 NULL입니다. lpdwBufferSize 가 NULL입니다.
ERROR_NOT_ENOUGH_MEMORY	작업을 완료할 리소스가 부족합니다.
ERROR_NO_SUCH_INTERFACE	hRouterInterface에 해당하는 인터페이스가 라우터 구성에 없습니다.

요구 사항


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