OpenPort 函式（winsplp.h）

發行項
02/07/2025

埠監視器的 OpenPort 函式會開啟印表機埠。

語法

BOOL OpenPort(
  LPWSTR  pName,
  PHANDLE pHandle
);

參數

pName

呼叫端提供的字串指標，其中包含要開啟之埠的名稱。

pHandle

呼叫端提供的位置指標，以接收埠句柄。

傳回值

如果工作成功，函式應該 TRUE傳回。否則，它應該 FALSE傳回。

言論

需要埠監視伺服器 DLL 才能定義 OpenPort 函式，並在 MONITOR2 結構中包含函式的位址。

OpenPort 函式會在列印佇列連接到埠時，由語言監視器或列印後台處理程式呼叫。 OpenPort 函式的主要用途是傳回埠句柄，呼叫者可以使用做為輸入自變數，以便後續呼叫埠監視器的 startDocPort、WritePort、ReadPort、EndDocPort和 GetPrinterDataFromPort 函式。

除了傳回埠句柄之外，OpenPort 函式還可以執行在讀取或寫入作業執行之前必須處理的初始化作業。例如，如果埠支援可修改的逾時值，OpenPort 函式應該設定這些值。

OpenPort 的呼叫不是列印作業特定的。在對埠監視器的 OpenPort 和 ClosePort 函式的每個呼叫之間，可以多次呼叫其 StartDocPort 和 EndDocPort 函式。

您可以假設在列印多任務緩衝處理程式呼叫 具有特定埠名稱的 OpenPort 之後，在 呼叫 closePort之前，不會再使用相同的埠名稱呼叫 OpenPort。

列印接受埠句柄做為輸入的監視器函式，也不接受監視句柄。因此，OpenPort 函式必須將接收的監視句柄儲存在埠句柄可以參考的位置。這可讓接受埠句柄的函式參考監視句柄。