DeletePortUI 함수(winsplp.h)

아티클
08/08/2023

포트 모니터 UI DLL의 DeletePortUI 함수는 프린터 포트를 삭제합니다.

구문

BOOL DeletePortUI(
  [in, optional] PCWSTR pszServer,
  [in]           HWND   hWnd,
  [in]           PCWSTR pszPortName
);

매개 변수

[in, optional] pszServer

서버 이름을 나타내는 문자열에 대한 호출자 제공 포인터 또는 프린터가 로컬인 경우 NULL 입니다. (포트 모니터는 이 매개 변수를 무시할 수 있습니다.)

[in] hWnd

대화 상자의 부모로 사용해야 하는 창의 호출자 제공 핸들입니다. NULL인 경우 대화 상자가 표시되지 않아야 합니다.

[in] pszPortName

삭제할 포트의 이름을 나타내는 문자열에 대한 호출자 제공 포인터입니다.

반환 값

작업이 성공하면 함수는 TRUE를 반환해야 합니다. 그렇지 않으면 FALSE를 반환해야 합니다. 사용자가 작업을 취소하거나 지원되지 않는 경우 함수는 SetLastError(ERROR_CANCELLED)를 호출한 다음 FALSE를 반환해야 합니다.

설명

포트 모니터 UI DLL은 DeletePortUI 함수를 정의하고 함수의 주소를 MONITORUI 구조에 포함해야 합니다.

스풀러는 DeletePort 함수 내에서 DeletePortUI를 호출합니다. DeletePortUI에서 받은 인수는 DeletePort에서 받은 인수입니다. DeletePort 함수는 Microsoft Windows SDK 설명서에 설명되어 있습니다.

함수는 다음 작업을 수행해야 합니다.

다음 형식의 프린터 이름을 지정하여 OpenPrinter를 호출합니다.

\\ServerName\,XcvPortPortName

여기서 ServerName 및 PortName 은 DeletePortUI 함수 인수로 수신된 서버 및 포트 이름입니다.

OpenPrinter를 호출하려면 Windows SDK 설명서에 설명된 PRINTER_DEFAULTS 구조가 필요합니다. 구조체의 DesiredAccess 멤버는 SERVER_ACCESS_ADMINISTER 설정해야 합니다. pDatatype 및 pDevMode 멤버는 NULL일 수 있습니다.

이 호출로 인해 인쇄 모니터 서버 DLL의 XcvOpenPort 함수가 호출됩니다.
다음 입력 인수를 지정하여 XcvData를 호출합니다.
- OpenPrinter에서 받은 핸들
- 함수 인수로 받은 포트 이름
- "DeletePort"의 데이터 이름 문자열
이 호출로 인해 서버 DLL의 XcvClosePort 함수가 호출됩니다.
사용자 상호 작용이 필요한 경우 대화 상자를 표시하여 사용자로부터 정보를 가져온 다음 XcvData를 호출하여 사용자 지정된 데이터 이름 문자열을 지정하여 정보를 서버 DLL로 보냅니다. XcvData 호출로 인해 서버의 XcvDataPort 함수가 호출됩니다.
OpenPrinter에서 받은 핸들을 지정하여 ClosePrinter를 호출합니다. 이로 인해 서버 DLL의 XcvClosePort 함수가 호출됩니다.