MprAdminPortEnum 함수(mprapi.h)
MprAdminPortEnum 함수는 특정 연결의 모든 활성 포트 또는 RAS에서 사용하거나 현재 사용하는 모든 포트를 열거합니다.
구문
DWORD MprAdminPortEnum(
[in] RAS_SERVER_HANDLE hRasServer,
[in] DWORD dwLevel,
[in] HANDLE hRasConnection,
[out] LPBYTE *lplpbBuffer,
[in] DWORD dwPrefMaxLen,
[out] LPDWORD lpdwEntriesRead,
[out] LPDWORD lpdwTotalEntries,
[in] LPDWORD lpdwResumeHandle
);
매개 변수
[in] hRasServer
포트를 열거할 RAS 서버에 대한 핸들입니다. 이 핸들을 가져오려면 MprAdminServerConnect를 호출합니다.
[in] dwLevel
lplpbBuffer 매개 변수에서 정보가 반환되는 형식을 설명하는 DWORD 값입니다. 0이어야 합니다.
[in] hRasConnection
활성 포트가 열거되는 연결에 대한 핸들입니다. 이 매개 변수가 INVALID_HANDLE_VALUE 경우 RRAS에서 사용하거나 사용할 수 있는 모든 포트가 열거됩니다. 이 핸들을 가져오려면 MprAdminConnectionEnum을 호출합니다.
[out] lplpbBuffer
성공적으로 완료되면 포트를 설명하는 RAS_PORT_0 구조체 배열에 대한 포인터입니다. MprAdminBufferFree를 호출하여 이 메모리를 해제합니다.
[in] dwPrefMaxLen
반환된 데이터의 기본 설정 최대 길이(8비트 바이트)를 지정하는 값입니다. 이 매개 변수가 -1이면 반환되는 버퍼는 사용 가능한 모든 데이터를 저장할 수 있을 만큼 큽습니다.
[out] lpdwEntriesRead
DWORD 변수에 대한 포인터입니다. 이 변수는 현재 다시 시작 위치에서 열거된 포트의 총 수를 받습니다.
[out] lpdwTotalEntries
DWORD 변수에 대한 포인터입니다. 이 변수는 현재 다시 시작 위치에서 열거될 수 있는 총 포트 수를 받습니다.
[in] lpdwResumeHandle
DWORD 변수에 대한 포인터입니다. 성공적으로 실행되면 이 매개 변수는 열거형을 다시 시작하는 데 사용할 수 있는 핸들을 지정합니다. 이 매개 변수는 첫 번째 호출에서 0이어야 하며 후속 호출에서는 변경되지 않은 상태로 유지되어야 합니다. 반환 코드가 ERROR_MORE_DATA 경우 더 많은 데이터를 검색하기 위해 핸들을 사용하여 호출을 다시 실행할 수 있습니다. 반환할 때 핸들이 NULL 이면 열거형을 계속할 수 없습니다. 이 핸들은 다른 유형의 오류 반환에 유효하지 않습니다.
반환 값
함수가 성공하면 반환 값이 NO_ERROR.
함수가 실패하면 반환 값은 다음 표에 나열된 오류 코드 중 하나입니다.
| 값 | 의미 |
|---|---|
|
호출 애플리케이션에는 충분한 권한이 없습니다. |
|
DDM(Demand Dial Manager)이 실행되고 있지 않습니다. DIM(동적 인터페이스 관리자)이 LAN에서만 실행되도록 구성되었기 때문일 수 있습니다. |
|
다음 매개 변수 중 하나 이상이 NULL 이거나 유효한 메모리를 가리키지 않습니다. lplpBuffer, lpdwEntriesRead 또는 lpdwTotalEntries입니다. |
|
이 호출로 모든 데이터가 반환된 것은 아닙니다. 추가 데이터를 가져오려면 IpdwResumeHandle 매개 변수에 반환된 핸들을 사용하여 함수를 다시 호출합니다. |
|
dwLevel 매개 변수가 0이 아닙니다. |
|
hConnection 매개 변수는 NULL입니다. |
|
MprError.h, RasError.h 또는 WinError.h의 오류입니다. |
설명
RRAS 재배포 가능 패키지가 설치된 경우 이 함수는 Windows NT 4.0에서 사용할 수 있습니다. 그러나 RRAS 재배포 가능 패키지와 함께 제공되는 Mprapi.dll 버전은 함수를 MprAdminPortEnum이 아닌 RasAdminPortEnum으로 내보냅니다. 따라서 RRAS 재배포 가능 파일을 사용하는 경우 LoadLibrary 및 GetProcAddress 를 사용하여 이 함수에 액세스합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | mprapi.h |
| 라이브러리 | Mprapi.lib |
| DLL | Mprapi.dll |