共用方式為

MprAdminPortGetInfo 函式 (mprapi.h)

  • 發行項

MprAdminPortGetInfo 函式會取得特定埠的資訊。

語法

DWORD MprAdminPortGetInfo(
  [in]  RAS_SERVER_HANDLE hRasServer,
  [in]  DWORD             dwLevel,
  [in]  HANDLE            hPort,
  [out] LPBYTE            *lplpbBuffer
);

參數

[in] hRasServer

處理要收集埠資訊的 RAS 伺服器電腦。 藉由呼叫 MprAdminServerConnect 來取得此句柄。

[in] dwLevel

DWORD 值，描述 lplpbBuffer 參數中傳回資訊的格式。 dwLevel 可接受的值為 0 和 1，如下表所列。

值 結構格式
0 RAS_PORT_0
1 RAS_PORT_1

[in] hPort

要收集資訊的埠句柄。 藉由呼叫 MprAdminPortEnum 來取得此句柄。

[out] lplpbBuffer

成功完成時，描述埠之結構的指標。 根據 dwLevel 參數的值，這些結構的類型為RAS_PORT_0或RAS_PORT_1。 藉由呼叫 MprAdminBufferFree 來釋放此記憶體。

傳回值

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

如果函式失敗，傳回值就是下列其中一個錯誤碼。

值 意義
ERROR_ACCESS_DENIED
 呼叫的應用程式沒有足夠的許可權。
ERROR_DDM_NOT_RUNNING
 需求撥號管理員 (DDM) 未執行，可能是因為動態介面管理員 (DIM) 設定為只在 LAN 上執行。
ERROR_INVALID_PARAMETER
 下列至少一個參數是 NULL ，或未指向有效的記憶體： lplpBuffer、 lpdwEntriesRead 或 lpdwTotalEntries。
ERROR_INVALID_PORT_HANDLE
 hPort 參數無效。
ERROR_NOT_SUPPORTED
 dwLevel 參數不是零。
其他
 來自 MprError.h、RasError.h 或 WinError.h 的錯誤。
 
 

備註

如果已安裝 RRAS 可轉散發套件，此函式可在 Windows NT 4.0 上使用。 不過，隨附 RRAS 可轉散發套件的 Mprapi.dll 版本會將函式導出為 RasAdminPortGetInfo ，而不是 MprAdminPortGetInfo。 因此，使用 RRAS 可轉散發套件時，請使用 LoadLibrary 和 GetProcAddress 來存取此函式。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 mprapi.h
程式庫 Mprapi.lib
Dll Mprapi.dll

另請參閱

MprAdminBufferFree

MprAdminPortEnum

MprAdminServerConnect

RAS 系統管理功能

遠端訪問服務管理參考