RasAdminPortEnum 函式

[此函式僅適用于與 server 4.0 Windows NT的回溯相容性。它會在 Windows Server 2003 上傳回ERROR_CALL_NOT_IMPLEMENTED。應用程式應該使用 MprAdminPortEnum 函式。]

RasAdminPortEnum函式會列舉指定 RAS 伺服器上的所有埠。針對伺服器上的每個埠，函式會傳回包含埠相關資訊 的 RAS_PORT_0 結構。

語法

DWORD RasAdminPortEnum(
  _In_  const WCHAR       *lpszServer,
  _Out_       PRAS_PORT_0 *ppRasPort0,
  _Out_       WORD        *pcEntriesRead
);

lpszServer [in]: 指定 RAS 伺服器名稱之 Null 終止 Unicode 字串的指標。以 \\servername格式指定具有前置「\\」字元的名稱。
ppRasPort0 [out]: 接收緩衝區指標的變數指標，該緩衝區包含 RAS_PORT_0 結構的陣列。當應用程式完成記憶體時，請呼叫 RasAdminFreeBuffer 函式來釋放它。
pcEntriesRead [out]: 16 位變數的指標，該變數會接收ppRasPort0陣列中傳回之RAS_PORT_0結構的總數。

如果函式成功，傳回值會ERROR_SUCCESS。

如果函式失敗，傳回值可以是下列錯誤碼。

值	意義
NERR_ItemNotFound	無法列舉埠。這可能是因為伺服器上所有已設定的埠目前正在用於撥出。

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