MprAdminConnectionEnum 함수(mprapi.h)

아티클
02/29/2024

MprAdminConnectionEnum 함수는 모든 활성 연결을 열거합니다.

구문

DWORD MprAdminConnectionEnum(
  [in]  RAS_SERVER_HANDLE hRasServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer,
  [in]  DWORD             dwPrefMaxLen,
  [out] LPDWORD           lpdwEntriesRead,
  [out] LPDWORD           lpdwTotalEntries,
  [in]  LPDWORD           lpdwResumeHandle
);

매개 변수

[in] hRasServer

연결이 열거되는 RAS 서버에 대한 핸들입니다. 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

[out] lplpbBuffer

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

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

[in] dwPrefMaxLen

반환된 데이터의 기본 설정 최대 길이를 8비트 바이트로 지정합니다. dwPrefMaxLen이 -1인 경우 반환되는 버퍼는 사용 가능한 모든 정보를 저장할 수 있을 만큼 큽 수 있습니다.

[out] lpdwEntriesRead

DWORD 변수에 대한 포인터입니다. 이 변수는 현재 다시 시작 위치에서 열거된 총 연결 수를 받습니다.

[out] lpdwTotalEntries

DWORD 변수에 대한 포인터입니다. 이 변수는 현재 다시 시작 위치에서 열거될 수 있는 총 연결 수를 받습니다.

[in] lpdwResumeHandle

DWORD 변수에 대한 포인터입니다. 이 변수는 열거형을 계속하는 데 사용되는 다시 시작 핸들을 지정합니다. lpdwResumeHandle 매개 변수는 첫 번째 호출에서 0이며 후속 호출에서는 변경되지 않은 상태로 유지됩니다. 반환 코드가 ERROR_MORE_DATA 경우 이 핸들을 사용하여 다른 호출을 수행하여 더 많은 데이터를 검색할 수 있습니다. 반환 시 핸들이 NULL 이면 열거형이 완료됩니다. 이 핸들은 다른 유형의 오류 반환에 유효하지 않습니다.

반환 값

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

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

값	의미
ERROR_DDM_NOT_RUNNING	DDM(Demand Dial Manager)이 실행되고 있지 않습니다. DIM(동적 인터페이스 관리자)이 LAN에서만 실행되도록 구성되어 있기 때문일 수 있습니다.
ERROR_INVALID_LEVEL	dwLevel에 전달된 값이 0, 1, 2 또는 3이 아닙니다. 수준 1과 2는 Windows 2000 이상에서만 지원됩니다. 수준 3은 Windows Server 2008 이상에서만 지원됩니다.
ERROR_INVALID_PARAMETER	다음 매개 변수 중 하나 이상이 NULL 이거나 유효한 메모리를 가리키지 않습니다. lplpBuffer, lpdwEntriesRead 또는 lpdwTotalEntries입니다.
ERROR_MORE_DATA	모든 데이터가 이 호출과 함께 반환되지는 않았습니다. 추가 데이터를 가져오려면 다시 시작 핸들을 사용하여 함수를 다시 호출합니다.
RPC_S_INVALID_BINDING	hRasServer 매개 변수에 전달된 핸들이 NULL이거나 잘못되었습니다.
기타	MprError.h, RasError.h 또는 WinError.h의 오류입니다.

설명

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

요구 사항

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