RasAdminReleaseIpAddress 回呼函式

[RasAdminReleaseIpAddress函式可用於 Windows NT 4.0，且後續版本無法使用。請改用 MprAdminReleaseIpAddress。]

RasAdminReleaseIpAddress函式是由協力廠商 RAS 伺服器管理 DLL 匯出的應用程式定義函式。 RAS 會呼叫此函式，以通知 DLL 遠端用戶端已中斷連線，而且應該釋放 IP 位址。

語法

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

lpszUserName [in]: 指定 Null 終止 Unicode 字串的指標，指定先前使用 RasAdminGetIpAddressForUser 函式取得 IP 位址的遠端使用者名稱。
lpszPortName [in]: Null 終止 Unicode 字串的指標，指定 lpszUserName 所指定使用者所連接之埠的名稱。
pipAddress [in]: IPADDR變數的指標，指定先前呼叫RasAdminGetIpAddressForUser中為此使用者傳回的 IP 位址。

此函式沒有擴充的錯誤資訊;不呼叫 GetLastError。

只有在應用程式在先前呼叫RasAdminGetIpAddressForUser 時，應用程式在先前呼叫 RasAdminGetIpAddressForUser時，才會在bNotifyRelease參數中傳回TRUE時呼叫 RasAdminReleaseIpAddressForUser。

協力廠商 RAS 系統管理 DLL 的安裝程式必須藉由在登錄中提供下列機碼下的資訊，向 RAS 註冊 DLL：

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         RAS
            AdminDll

若要註冊 DLL，請在此機碼下設定下列值。

值名稱	值資料
DisplayName	包含 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 的登錄專案。