XcvOpenPort 函数 (winsplp.h)

项目
08/08/2023

端口监视器服务器 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”之一， (Microsoft Windows SDK文档中所述，后台处理程序的 OpenPrinter 函数) 调用 XcvOpenPort。有关详细信息，请参阅 AddPortUI。

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

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