다음을 통해 공유


PTConvertDevModeToPrintTicket 함수(prntvpt.h)

DEVMODE 구조를 IStream 내의 인쇄 티켓으로 변환합니다.

구문

HRESULT PTConvertDevModeToPrintTicket(
  [in] HPTPROVIDER       hProvider,
       ULONG             cbDevmode,
  [in] PDEVMODE          pDevmode,
  [in] EPrintTicketScope scope,
       IStream           *pPrintTicket
);

매개 변수

[in] hProvider

열려 있는 인쇄 티켓 공급자에 대한 핸들입니다. 이 핸들은 PTOpenProvider 또는 PTOpenProviderEx 함수에 의해 반환됩니다.

cbDevmode

DEVMODE의 크기(바이트)입니다.

[in] pDevmode

DEVMODE에 대한 포인터입니다.

[in] scope

pPrintTicket의 scope 지정하는 값입니다. 이 값은 단일 페이지, 전체 문서 또는 인쇄 작업의 모든 문서를 지정할 수 있습니다. 지정된 scope 외부에 있는 pDevmode의 설정은 pPrintTicket에 포함되지 않습니다. 설명 부분을 참조하세요.

pPrintTicket

인쇄 티켓의 시작 부분에 검색 위치가 있는 IStream 에 대한 포인터입니다.

반환 값

작업이 성공하면 반환 값이 S_OK, 그렇지 않으면 HRESULT 에 오류 코드가 포함됩니다.

hProvider가 다른 스레드에서 열린 경우 HRESULT는 E_INVALIDARG.

COM 오류 코드에 관한 자세한 내용은 오류 처리를 참조하세요.

설명

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

pDevmode가 다른 프린터를 가리키는 경우 해당 설정이 손실되어 기본값으로 대체될 수 있습니다.

scope 외부에 있는 pDevmode의 설정은 pPrintTicket에 포함되지 않습니다. 예를 들어 scope 단일 페이지인 경우 작업 전체 설정 및 문서 전체 설정이 포함되지 않습니다. 작업 scope 문서 scope 및 페이지 scope 포함합니다. 문서 scope 페이지 scope 포함합니다.

PTConvertDevModeToPrintTicket는 스트림의 현재 검색 지점에서 시작하여 pPrintTicket에서 참조하는 IStream에 인쇄 티켓을 씁니다. PTConvertDevModeToPrintTicket가 반환된 후 호출자는 검색 지점을 초기 검색 지점으로 다시 설정하여 함수에서 반환한 인쇄 티켓을 읽어야 합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 prntvpt.h
라이브러리 Prntvpt.lib
DLL Prntvpt.dll

추가 정보

인쇄 스키마

인쇄 스풀러 API 함수

인쇄