XcvOpenPort 函式 (winsplp.h)

發行項
03/01/2024

埠監視器伺服器 DLL 的 XcvOpenPort 函式會開啟組態作業的埠。

語法

BOOL XcvOpenPort(
  LPCWSTR     pszObject,
  ACCESS_MASK GrantedAccess,
  PHANDLE     phXcv
);

參數

pszObject

呼叫端提供的字串指標，代表埠的名稱。可以是 NULL，而且大部分的監視器不需要此參數。

GrantedAccess

呼叫端提供的ACCESS_MASK結構，其中包含在列印監視器 UI DLL 對 spooler 的 OpenPrinter 函式呼叫期間授與使用者的存取權。請參閱下列一節。

phXcv

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

傳回值

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

備註

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

如果指定的印表機名稱包含字串「XcvPort」或「XcvMonitor」，則後台處理程式的 OpenPrinter 函式 (Microsoft Windows SDK) 會呼叫 XcvOpenPort。如需詳細資訊，請參閱 AddPortUI。

XcvOpenPort 函式應該會開啟埠以供設定之用。這項作業可能只包含儲存輸入自變數，以供在 XcvDataPort 內後續使用。函式應該會傳回 phXcv 所指向位置中預存資訊的句柄。這個句柄會傳回給 OpenPrinter 的呼叫端，然後接收為 XcvDataPort 的輸入自變數。

函式應該儲存授與的存取掩碼。稍後，呼叫伺服器 DLL 的 XcvDataPort 函式時，授與的存取權應該與SERVER_ACCESS_ADMINISTER比較，如果比較失敗， XcvDataPort 應該會傳回ERROR_ACCESS_DENIED。