DeletePortUI 함수(winsplp.h)

포트 모니터 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 설명서에 설명되어 있습니다.)

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

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

   \\ ServerName\,XcvPortPortName

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

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

   이 호출로 인해 인쇄 모니터 서버 DLL의 XcvOpenPort 함수가 호출됩니다.

2. 다음 입력 인수를 지정하여 XcvData호출합니다.
   • OpenPrinter 받은 핸들
   • 함수 인수로 수신된 포트 이름
   • "DeletePort"의 데이터 이름 문자열

   이 호출로 인해 서버 DLL의 XcvClosePort 함수가 호출됩니다.

3. 사용자 상호 작용이 필요한 경우 대화 상자를 표시하여 사용자로부터 정보를 가져온 다음, 사용자 지정된 데이터 이름 문자열을 지정하는 XcvData호출하여 정보를 서버 DLL로 보냅니다. XcvData 호출하면 서버의 XcvDataPort 함수가 호출됩니다.
4. ClosePrinter호출하여 OpenPrinter받은 핸들을 지정합니다. 이로 인해 서버 DLL의 XcvClosePort 함수가 호출됩니다.

요구 사항

요구	값
대상 플랫폼	바탕 화면
헤더	winsplp.h(Winsplp.h 포함)

참고 항목

XcvClosePort

XcvData

XcvDataPort

XcvOpenPort