AddPrintDeviceObject 함수(winsplp.h)
경고
Windows 10부터 타사 인쇄 공급자를 지원하는 API는 더 이상 사용되지 않습니다. Microsoft는 타사 인쇄 공급자에 대한 투자를 권장하지 않습니다. 또한 v4 인쇄 드라이버 모델을 사용할 수 있는 Windows 8 및 최신 제품에서는 타사 인쇄 공급자가 v4 인쇄 드라이버를 사용하는 큐를 만들거나 관리할 수 없습니다.
AddPrintDeviceObject 인쇄 공급자 함수는 인쇄 공급자 큐에 대한 디바이스 개체를 만듭니다.
통사론
HRESULT AddPrintDeviceObject(
[in] HANDLE hPrinter,
[out] HANDLE *phDeviceObject
);
매개 변수
[in] hPrinter
열려 있는 프린터에 대한 HANDLE입니다. AddPrinter 또는 OpenPrinter 스풀러 함수에서 반환되는 HANDLE이어야 합니다.
[out] phDeviceObject
성공적으로 만들어진 경우 디바이스 개체에 대한 HANDLE입니다.
반환 값
AddPrintDeviceObject 함수는 디바이스 개체가 성공적으로 만들어진 경우 S_OK 반환합니다. 그렇지 않으면 오류를 반환합니다.
발언
다음과 같은 상황에서 AddPrintDeviceObject 함수를 호출해야 합니다.
사용자가 프린터를 설치합니다.
프린터를 설치한 후 인쇄 공급자가 이 함수를 호출해야 합니다.
프린터를 설치하는 사용자를 가장하여 함수를 호출해야 합니다.
스풀러 서비스가 시작된 후 인쇄 공급자가 초기화됩니다.
인쇄 공급자는 공급자가 소유한 이전에 설치된 각 프린터에 대해 이 함수를 호출해야 합니다. 이 시간 동안 AddPrintDeviceObject 호출할 때 사용자 컨텍스트를 가장할 필요가 없습니다.
AddPrintDeviceObject 사용하여 추가된 모든 디바이스 개체는 RemovePrintDeviceObject사용하여 제거하거나 스풀러 서비스가 다시 시작될 때까지 유지됩니다. 스풀러 서비스가 중지되면 모든 디바이스 개체가 자동으로 삭제됩니다.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 바탕 화면 |
| 헤더 | winsplp.h(Winspool.h 포함) |
| 라이브러리 | WinSpool.lib |
| DLL | WinSpool.drv |