InitializePrintMonitor 函式 (winsplp.h)

  • 發行項

InitializePrintMonitor 函式已經過時，而且僅支援相容性用途。 新的列印監視器應該實作 InitializePrintMonitor2 ，以便與列印伺服器叢集搭配使用。

列印監視器的 InitializePrintMonitor 函式會初始化列印監視器。

語法

LPMONITOREX InitializePrintMonitor(
  [in] LPWSTR pRegistryRoot
);

參數

[in] pRegistryRoot

呼叫端提供的字串指標，識別列印監視器可用來儲存監視特定值的登錄路徑。

傳回值

如果作業成功，函式應該會傳回 MONITOREX 結構的指標。 否則，函式應該呼叫 SetLastError (Microsoft Windows SDK 檔) 中所述來設定錯誤碼，並傳回 NULL。

備註

InitializePrintMonitor 函式必須由語言監視器和埠監視伺服器 DLL 導出。 載入監視 DLL 之後，會立即呼叫 函式，而且在重載 DLL 之前不會再次呼叫。 其用途是允許監視器自行初始化，以及提供多任務緩衝處理程式內部監視器函式的指標。 函式指標包含在 MONITOR 結構中，這是透過 MONITOREX 函式所參考。

pRegistryRoot 參數會提供代表 MonitorName 登錄機碼路徑的字串指標，其中 MonitorName 是呼叫 spooler 的 AddMonitor 函式來新增監視器時所指定的監視名稱。 監視器可以使用此金鑰來儲存監視特定的值名稱和值。 呼叫多任務緩衝處理程式的 DeleteMonitor 函式時，多任務緩衝處理程式會刪除 MonitorName 機碼，以及儲存在其下的所有值。 (addMonitor 和 DeleteMonitor 函式會在 Windows SDK documentation.)

規格需求

需求 值
目標平台 桌面
標頭 winsplp.h (包含 Winsplp.h)

另請參閱

InitializePrintMonitorUI

MONITOREX