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
Unicode 字串的指標，指定需要 IP 位址的使用者名稱。
[in] lpwszPortName
Unicode 字串的指標，指定使用者嘗試連接之埠的名稱。
[in, out] lpdwIpAddress
在輸入時，指向包含零或為使用者配置之 IP 位址 RAS 的 DWORD 變數指標。
在輸出中，如果 RAS 指定零，DLL 會為使用者配置 IP 位址。 在此情況下，如果 DLL 未配置 IP 位址，使用者就無法連線。 如果 RAS 指定了 IP 位址，DLL 會接受位址或替代不同的位址。
[out] bNotifyRelease
BOOL變數的指標。 如果 DLL 將此變數設定為 TRUE，則 RAS 會在使用者中斷連線時呼叫 MprAdminReleaseIpAddress 。 否則，當釋放此 IP 位址時，RAS 不會通知 DLL。
傳回值
如果函式成功，則傳回值應該NO_ERROR。
如果函式傳回NO_ERROR以外的任何專案，RAS 將會終止連線。
備註
RAS 支援多個系統管理 DLL。 不過，RAS 只會在實作和匯出它的第一個 DLL 中呼叫 MprAdminGetIpAddressForUser 。 RAS 會忽略其他 DLL 中這些函式的實作。 RAS 會依照這些函式列在 登錄中的順序檢查這些函式的 DLL。
系統管理 DLL 不需要實作 MprAdminGetIpAddressForUser 函 式。 不過，如果 DLL 實作 MprAdminGetIpAddressForUser，它也必須實作 MprAdminReleaseIpAddress。
請勿從MprAdminGetIpAddressForUser內部呼叫任何RAS Administration Functions或RAS 使用者系統管理功能。 從圖說文字函式內進行時，不會傳回這些函式的呼叫。
需求
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | mprapi.h |