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 Windows SDK 文档中所述）调用 XcvOpenPort。有关详细信息，请参阅 AddPortUI。

XcvOpenPort 函数应打开端口以进行配置。此作可能只包括存储输入参数，以便在 XcvDataPort中使用。该函数应返回 phXcv指向的位置中存储信息的句柄。此句柄将返回到 OpenPrinter的调用方，随后作为输入参数接收，以 XcvDataPort。

该函数应保存授予的访问掩码。稍后，当调用服务器 DLL 的 XcvDataPort 函数时，应将授予的访问权限与SERVER_ACCESS_ADMINISTER进行比较;如果比较失败，XcvDataPort 应返回ERROR_ACCESS_DENIED。