XcvOpenPort 函式（winsplp.h）

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

語法

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

pszObject

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

GrantedAccess

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

phXcv

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

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

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

如果指定的印表機名稱包含字串「XcvPort」或「XcvMonitor」，則多任務緩衝處理程式的 OpenPrinter 函式 Microsoft 會呼叫 XcvOpenPort。如需詳細資訊，請參閱 AddPortUI。

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

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