MprAdminPortGetInfo 함수(mprapi.h)

  • 아티클

MprAdminPortGetInfo 함수는 특정 포트에 대한 정보를 가져옵니다.

구문

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

매개 변수

[in] hRasServer

포트 정보를 수집할 RAS 서버 컴퓨터에 대한 핸들입니다. MprAdminServerConnect를 호출하여 이 핸들을 가져옵니다.

[in] dwLevel

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

값 구조체 형식
0 RAS_PORT_0
1 RAS_PORT_1

[in] hPort

정보를 수집할 포트에 대한 핸들입니다. MprAdminPortEnum을 호출하여 이 핸들을 가져옵니다.

[out] lplpbBuffer

성공적으로 완료되면 포트를 설명하는 구조체에 대한 포인터입니다. 이러한 구조체는 dwLevel 매개 변수의 값에 따라 RAS_PORT_0 형식이거나 RAS_PORT_1 형식입니다. MprAdminBufferFree를 호출하여 이 메모리를 해제합니다.

반환 값

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

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

값 의미
ERROR_ACCESS_DENIED
 호출 애플리케이션에는 충분한 권한이 없습니다.
ERROR_DDM_NOT_RUNNING
 DDM(Demand Dial Manager)이 실행되고 있지 않습니다. DIM(동적 인터페이스 관리자)이 LAN에서만 실행되도록 구성되었기 때문일 수 있습니다.
ERROR_INVALID_PARAMETER
 다음 매개 변수 중 하나 이상이 NULL 이거나 유효한 메모리를 가리키지 않습니다. lplpBuffer, lpdwEntriesRead 또는 lpdwTotalEntries입니다.
ERROR_INVALID_PORT_HANDLE
 hPort 매개 변수가 잘못되었습니다.
ERROR_NOT_SUPPORTED
 dwLevel 매개 변수가 0이 아닙니다.
기타
 MprError.h, RasError.h 또는 WinError.h의 오류입니다.
 
 

설명

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

요구 사항

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

추가 정보

MprAdminBufferFree

MprAdminPortEnum

MprAdminServerConnect

RAS 관리 함수

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