OpenPort 函式 (winsplp.h)
埠監視器的 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 函式必須將接收的監視句柄儲存在埠句柄可參考的位置。 這可讓接受埠句柄的函式參考監視句柄。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 桌面 |
| 標頭 | winsplp.h (包含 Winsplp.h) |
| 程式庫 | NtosKrnl.exe |