OpenPort 함수(winsplp.h)

아티클
02/27/2024

포트 모니터의 OpenPort 함수는 프린터 포트를 엽니다.

구문

BOOL OpenPort(
  LPWSTR  pName,
  PHANDLE pHandle
);

매개 변수

pName

열 포트의 이름을 포함하는 문자열에 대한 호출자 제공 포인터입니다.

pHandle

포트 핸들을 받을 위치에 대한 호출자 제공 포인터입니다.

반환 값

작업이 성공하면 함수는 TRUE를 반환해야 합니다. 그렇지 않으면 FALSE를 반환해야 합니다.

설명

포트 모니터 서버 DLL은 OpenPort 함수를 정의하고 함수의 주소를 MONITOR2 구조에 포함해야 합니다.

OpenPort 함수는 인쇄 큐가 포트에 연결될 때 언어 모니터 또는 인쇄 스풀러에 의해 호출됩니다. OpenPort 함수의 주요 목적은 호출자가 포트 모니터의 StartDocPort, WritePort, ReadPort, EndDocPort 및 GetPrinterDataFromPort 함수에 대한 후속 호출에 대한 입력 인수로 사용할 수 있는 포트 핸들을 반환하는 것입니다.

포트 핸들을 반환하는 것 외에도 OpenPort 함수는 읽기 또는 쓰기 작업을 수행하기 전에 처리해야 하는 초기화 작업을 수행할 수 있습니다. 예를 들어 포트에서 수정 가능한 제한 시간 값을 지원하는 경우 OpenPort 함수는 이러한 값을 설정해야 합니다.

OpenPort에 대한 호출은 작업별로 인쇄되지 않습니다. 포트 모니터의 OpenPort 및 ClosePort 함수에 대한 각 호출 사이에는 StartDocPort 및 EndDocPort 함수에 대한 여러 호출 이 있을 수 있습니다.

인쇄 스풀러가 특정 포트 이름으로 OpenPort를 호출한 후에는 ClosePort를 호출하기 전에 동일한 포트 이름으로 OpenPort를 다시 호출하지 않는다고 가정할 수 있습니다.

포트 핸들을 입력으로 수락하는 모니터 함수 인쇄도 모니터 핸들을 허용하지 않습니다. 따라서 OpenPort 함수는 수신된 모니터 핸들을 포트 핸들에서 참조할 수 있는 위치에 저장해야 합니다. 이렇게 하면 포트 핸들을 허용하는 함수가 모니터 핸들을 참조할 수 있습니다.