MprAdminConnectionEnumEx 함수(mprapi.h)

  • 아티클

MprAdminConnectionEnumEx 함수는 지정된 RRAS 서버에 대한 활성 연결을 열거합니다.

구문

DWORD MprAdminConnectionEnumEx(
  [in]  RAS_SERVER_HANDLE     hRasServer,
  [in]  PMPRAPI_OBJECT_HEADER pObjectHeader,
  [in]  DWORD                 dwPreferedMaxLen,
  [out] LPDWORD               lpdwEntriesRead,
  [out] LPDWORD               lpdwTotalEntries,
  [out] PRAS_CONNECTION_EX    *ppRasConn,
  [in]  LPDWORD               lpdwResumeHandle
);

매개 변수

[in] hRasServer

연결이 열거되는 RAS 서버에 대한 핸들입니다. MprAdminServerConnect를 호출하여 이 핸들을 가져옵니다.

[in] pObjectHeader

ppRasConn에서 받은 구조체 버전을 지정하는 MPRAPI_OBJECT_HEADER 구조체에 대한 포인터입니다.

[in] dwPreferedMaxLen

반환된 데이터의 기본 최대 길이를 8비트 바이트로 지정하는 값입니다. dwPrefMaxLen이 -1이면 반환된 버퍼가 사용 가능한 모든 정보를 보유할 수 있을 만큼 큽 수 있습니다.

[out] lpdwEntriesRead

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

[out] lpdwTotalEntries

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

[out] ppRasConn

출력에서 hRasServer의 RRAS 서버에 대한 활성 연결 정보를 포함하는 RAS_CONNECTION_EX 구조의 배열에 대한 포인터입니다. 배열 요소의 수는 lpdwEntriesRead가 가리키는 값에 따라 결정됩니다.

[in] lpdwResumeHandle

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

반환 값

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

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

값 의미
ERROR_ACCESS_DENIED
 호출 애플리케이션에는 충분한 권한이 없습니다.
ERROR_DDM_NOT_RUNNING
 DDM(Demand Dial Manager)이 실행되고 있지 않습니다.
ERROR_MORE_DATA
 이 호출로 모든 데이터가 반환된 것은 아닙니다. 추가 데이터를 가져오려면 다시 시작 핸들을 사용하여 함수를 다시 호출합니다.
ERROR_PROC_NOT_FOUND
 지정된 프로시저를 찾을 수 없습니다."라는 오류가 생성됩니다.
기타
 MprError.h, RasError.h 또는 WinError.h의 오류입니다.

설명

호출자는 MprAdminBufferFree 함수를 호출하여 ppRasConn이 가리키는 메모리를 해제해야 합니다.

요구 사항

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

추가 정보

MprAdminBufferFree

MprAdminConnectionEnum

MprAdminServerConnect

RAS 관리 함수

원격 액세스 서비스 관리 참조