XcvOpenPort 함수(winsplp.h)

아티클
03/01/2024

포트 모니터 서버 DLL의 XcvOpenPort 함수는 구성 작업을 위한 포트를 엽니다.

구문

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

매개 변수

pszObject

포트 이름을 나타내는 문자열에 대한 호출자 제공 포인터입니다. NULL일 수 있으며 대부분의 모니터에는 이 매개 변수가 필요하지 않습니다.

GrantedAccess

스풀러의 OpenPrinter 함수에 대한 인쇄 모니터 UI DLL 호출 중에 사용자에게 부여된 액세스 권한을 포함하는 호출자 제공 ACCESS_MASK 구조체입니다. 다음 설명 섹션을 참조하세요.

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 반환해야 합니다.