AddMonitor 函式

AddMonitor函式會安裝本機埠監視器，並連結組態、資料和監視檔案。

語法

BOOL AddMonitor(
  _In_ LPTSTR pName,
  _In_ DWORD  Level,
  _In_ LPBYTE pMonitors
);

pName [in]

Null 終止字串的指標，指定應該安裝監視器的伺服器名稱。對於僅支援本機安裝監視器的系統，此字串應該是 Null。

層級 [in]

pMonitors指向的結構版本。此值必須是 2。

pMonitors [in]

MONITOR_INFO_2結構的指標。如果pMonitors結構的pEnvironment成員是Null，則會使用呼叫端 (用戶端) 目前的環境，而不是目的地 (伺服器) 的環境。

請注意，如果環境不符合伺服器的環境，則呼叫將會失敗，也就是說，您只能新增針對伺服器架構所撰寫的監視器。

如果函式成功，則傳回值是非零值。

如果此函式失敗，則傳回值為零。

注意

這是封鎖或同步函式，可能不會立即傳回。此函式傳回的速度取決於執行時間因素，例如網路狀態、列印伺服器設定，以及撰寫應用程式時難以預測的印表機驅動程式實作因素。從管理與使用者介面互動的執行緒呼叫此函式，可能會使應用程式看起來沒有回應。

呼叫端必須具有 SeLoadDriverPrivilege。

在應用程式呼叫 AddMonitor 函式之前，監視器所需的所有檔案都必須複製到 SYSTEM32 目錄。

若要判斷目前安裝的埠監視器，請呼叫 EnumMonitors 函 式。

若要移除 AddMonitor新增的監視器，請呼叫 DeleteMonitor 函式。

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
標頭	Winspool.h (包含 Windows.h)
程式庫	Winspool.lib
DLL	Winspool.drv
Unicode 與 ANSI 名稱	AddMonitorW (Unicode) 和 AddMonitorA (ANSI)