ConnectToPrinterDlg 함수

ConnectToPrinterDlg 함수는 사용자가 네트워크의 프린터를 찾아 연결할 수 있는 대화 상자를 표시합니다. 사용자가 프린터를 선택하면 함수는 프린터에 대한 연결을 만들려고 시도합니다. 적합한 드라이버가 서버에 설치되어 있지 않으면 사용자에게 로컬로 프린터를 만들 수 있는 옵션이 제공됩니다.

구문

HANDLE ConnectToPrinterDlg(
  _In_ HWND  hwnd,
  _In_ DWORD Flags
);

매개 변수

hwnd [in]

대화 상자의 부모 창을 지정합니다.

Flags [in]

이 매개 변수는 예약되어 있으며 0이어야 합니다.

반환 값

함수가 성공하고 사용자가 프린터를 선택하면 반환 값은 선택한 프린터에 대한 핸들입니다.

함수가 실패하거나 사용자가 프린터를 선택하지 않고 대화 상자를 취소하면 반환 값은 NULL입니다.

설명

참고

이는 차단 또는 동기 함수이며 즉시 반환되지 않을 수 있습니다. 이 함수가 반환되는 빈도는 애플리케이션을 작성할 때 예측하기 어려운 네트워크 상태, 인쇄 서버 구성 및 프린터 드라이버 구현 요소와 같은 런타임 요인에 따라 달라집니다. 사용자 인터페이스와의 상호 작용을 관리하는 스레드에서 이 함수를 호출하면 애플리케이션이 응답하지 않는 것처럼 보일 수 있습니다.

ConnectToPrinterDlg 함수는 선택한 프린터에 대한 연결을 만들려고 시도합니다. 그러나 프린터가 있는 서버에 적합한 드라이버가 설치되어 있지 않은 경우 함수는 사용자에게 로컬로 프린터를 만드는 옵션을 제공합니다. 호출 애플리케이션은 PRINTER_INFO_2 구조로 GetPrinter를 호출한 다음 해당 구조체의 Attributes 멤버를 검사하여 함수가 로컬로 프린터를 만들었는지 여부를 확인할 수 있습니다.

애플리케이션은 DeletePrinter 를 호출하여 로컬 프린터를 삭제해야 합니다. 애플리케이션은 DeletePrinterConnection 을 호출하여 프린터에 대한 연결을 삭제해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
헤더	Winspool.h(Windows.h 포함)
라이브러리	Winspool.lib
DLL	WinSpool.drv

추가 정보

인쇄

인쇄 스풀러 API 함수

AddPrinterConnection

ClosePrinter

DeletePrinter

DeletePrinterConnection

GetPrinter

PRINTER_INFO_2