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 使用者系統管理功能。 從圖說文字函式內進行時，不會傳回這些函式的呼叫。

需求

另請參閱

MprAdminReleaseIpAddress

RAS 管理 DLL

RAS 管理功能

遠端存取服務管理參考