MprAdminConnectionGetInfo 함수(mprapi.h)

아티클
02/29/2024

MprAdminConnectionGetInfo 함수는 특정 연결에 대한 데이터를 검색합니다.

구문

DWORD MprAdminConnectionGetInfo(
  [in]  RAS_SERVER_HANDLE hRasServer,
  [in]  DWORD             dwLevel,
  [in]  HANDLE            hRasConnection,
  [out] LPBYTE            *lplpbBuffer
);

매개 변수

[in] hRasServer

연결 정보가 검색되는 컴퓨터에 대한 핸들입니다. 이 핸들을 가져오려면 MprAdminServerConnect를 호출합니다.

[in] dwLevel

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

Windows NT 4.0: 이 매개 변수는 0이어야 합니다.

값	구조체 형식
0	RAS_CONNECTION_0
1	Windows 2000 이상: RAS_CONNECTION_1
2	Windows 2000 이상: RAS_CONNECTION_2
3	Windows Server 2008 이상: RAS_CONNECTION_3

[in] hRasConnection

데이터를 검색할 연결에 대한 핸들입니다. 이 핸들을 가져오려면 MprAdminConnectionEnum을 호출합니다.

[out] lplpbBuffer

성공적으로 완료되면 연결을 설명하는 구조체 배열에 대한 포인터입니다. 이러한 구조체는 dwLevel 매개 변수의 값에 따라 RAS_CONNECTION_0, RAS_CONNECTION_1, RAS_CONNECTION_2 또는 RAS_CONNECTION_3 형식입니다.

이 메모리를 해제하려면 MprAdminBufferFree를 호출합니다.

반환 값

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

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

반환 코드	설명
ERROR_INVALID_PARAMETER	RAS 서버에 대한 핸들 또는 RAS 연결에 대한 핸들이 잘못되었습니다.
ERROR_INVALID_LEVEL	dwLevel에 전달된 값이 0, 1, 2 또는 3이 아닙니다. 수준 1과 2는 Windows 2000 이상에서만 지원됩니다. 수준 3은 Windows Server 2008 이상에서만 지원됩니다.
ERROR_INTERFACE_NOT_CONNECTED	hConnection 핸들이 잘못되었습니다.
RPC_S_INVALID_BINDING	hRasServer 핸들이 잘못되었습니다.
기타	MprError.h, RasError.h 또는 WinError.h의 오류입니다.

설명

이 함수는 RRAS 재배포 가능 패키지가 설치된 경우 Windows NT 4.0에서 사용할 수 있습니다. 그러나 RRAS 재배포 가능 패키지에 포함된 Mprapi.dll 버전은 함수를 MprAdminConnectionGetInfo가 아닌 RasAdminConnectionGetInfo로 내보냅니다. 따라서 RRAS 재배포 가능 파일을 사용하는 경우 LoadLibrary 및 GetProcAddress 를 사용하여 이 함수에 액세스합니다.

요구 사항

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