RasAdminReleaseIpAddress 콜백 함수

[RasAdminReleaseIpAddress 함수는 Windows NT 4.0에서 사용할 수 있으며 후속 버전에서는 사용할 수 없습니다. 대신 MprAdminReleaseIpAddress를 사용합니다.]

RasAdminReleaseIpAddress 함수는 타사 RAS 서버 관리 DLL에서 내보내는 애플리케이션 정의 함수입니다. RAS는 이 함수를 호출하여 원격 클라이언트의 연결이 끊어지고 IP 주소를 해제해야 한다는 것을 DLL에 알립니다.

구문

void CALLBACK RasAdminReleaseIpAddress(
  _In_ WCHAR  *lpszUserName,
  _In_ WCHAR  *lpszPortName,
  _In_ IPADDR *pipAddress
);

매개 변수

lpszUserName [in]

이전에 RasAdminGetIpAddressForUser 함수를 사용하여 IP 주소를 가져온 원격 사용자의 이름을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터를 지정합니다.

lpszPortName [in]

lpszUserName으로 지정된 사용자가 연결된 포트의 이름을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

pipAddress [in]

RasAdminGetIpAddressForUser에 대한 이전 호출에서 이 사용자에 대해 반환된 IP 주소를 지정하는 IPADDR 변수에 대한 포인터입니다.

반환 값

이 함수에 대한 확장된 오류 정보는 없습니다. GetLastError를 호출하지 않습니다.

설명

RAS 서버는 애플리케이션이 lpszUserName 매개 변수로 지정된 사용자에 대해 RasAdminGetIpAddressForUser를 이전에 호출하는 동안 bNotifyRelease 매개 변수에서 TRUE를 반환한 경우에만 RasAdminReleaseIpAddress 함수를 호출합니다.

타사 RAS 관리 DLL에 대한 설치 프로그램은 레지스트리의 다음 키 아래에 정보를 제공하여 DLL을 RAS에 등록해야 합니다.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         RAS
            AdminDll

DLL을 등록하려면 이 키 아래에 다음 값을 설정합니다.

값 이름	값 데이터
표시 이름	DLL의 사용자에게 친숙한 표시 이름을 포함하는 REG_SZ 문자열입니다.
DLLPath	DLL의 전체 경로를 포함하는 REG_SZ 문자열입니다.

 

예를 들어 ProElectron, Inc.라는 가상 회사의 RAS 관리 DLL에 대한 레지스트리 항목은 다음과 같습니다.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         RAS
            AdminDll

DisplayName: REG_SZ: ProElectron RAS 관리 DLLPath: REG_SZ : C:\nt\system32\ntwkadm.dll

RAS 관리 DLL에 대한 설치 프로그램은 제거/제거 기능도 제공해야 합니다. 사용자가 DLL을 제거하면 설치 프로그램에서 DLL의 레지스트리 항목을 삭제해야 합니다.