다음을 통해 공유


MprAdminGetIpAddressForUser 함수(mprapi.h)

RAS는 IP 주소가 필요한 각 사용자에 대해 MprAdminGetIpAddressForUser 함수를 한 번 호출합니다. RAS는 RAS가 사용자에 대해 선택하는 IP 주소를 사용하여 함수를 호출합니다. 이 함수를 구현하는 타사 DLL은 이 주소를 자체 선택 중 하나로 변경할 수 있습니다.

구문

DWORD MprAdminGetIpAddressForUser(
  [in]      WCHAR *lpwszUserName,
  [in]      WCHAR *lpwszPortName,
  [in, out] DWORD *lpdwIpAddress,
  [out]     BOOL  *bNotifyRelease
);

매개 변수

[in] lpwszUserName

IP 주소가 필요한 사용자의 이름을 지정하는 유니코드 문자열에 대한 포인터입니다.

[in] lpwszPortName

사용자가 연결을 시도하는 포트의 이름을 지정하는 유니코드 문자열에 대한 포인터입니다.

[in, out] lpdwIpAddress

입력 시 사용자에 대해 할당된 IP 주소 RAS 또는 0이 포함된 DWORD 변수에 대한 포인터입니다.

출력에서 RAS가 0을 지정한 경우 DLL은 사용자에 대한 IP 주소를 할당합니다. 이 경우 DLL이 IP 주소를 할당하지 않으면 사용자가 연결할 수 없습니다. RAS가 IP 주소를 지정한 경우 DLL은 주소를 수락하거나 다른 주소를 대체합니다.

[out] bNotifyRelease

BOOL 변수에 대한 포인터입니다. DLL이 이 변수를 TRUE로 설정하면 RAS는 사용자가 연결을 끊을 때 MprAdminReleaseIpAddress 를 호출합니다. 그렇지 않으면 RAS는 이 IP 주소가 해제될 때 DLL에 알리지 않습니다.

반환 값

함수가 성공하면 반환 값은 NO_ERROR 합니다.

함수가 NO_ERROR 이외의 항목을 반환하면 RAS는 연결을 종료합니다.

설명

RAS는 여러 관리 DLL을 지원합니다. 그러나 RAS는 MprAdminGetIpAddressForUser 를 구현하고 내보내는 첫 번째 DLL에서만 호출합니다. RAS는 다른 DLL에서 이러한 함수의 구현을 무시합니다. RAS는 이러한 함수에 대한 DLL을 레지스트리에 나열된 순서대로 확인 합니다.

관리 DLL은 MprAdminGetIpAddressForUser 함수를 구현할 필요가 없습니다. 그러나 DLL이 MprAdminGetIpAddressForUser를 구현하는 경우 MprAdminReleaseIpAddress도 구현해야 합니다.

MprAdminGetIpAddressForUser 내부에서 RAS 관리 함수 또는 RAS 사용자 관리 함수를 호출하지 마세요. 이러한 함수에 대한 호출은 설명선 함수 내에서 호출될 때 반환되지 않습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 mprapi.h

참고 항목

MprAdminReleaseIpAddress

RAS 관리 DLL

RAS 관리 함수

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