ConvertPrintTicketToDevModeThunk2 함수
[이 함수는 지원되지 않으며 이후 버전의 Windows에서 사용하지 않도록 설정되거나 삭제될 수 있습니다. PTConvertPrintTicketToDevMode 는 동등한 기능을 제공하며 대신 사용해야 합니다.]
인쇄 티켓을 DEVMODE 구조체로 변환합니다.
구문
HRESULT ConvertPrintTicketToDevModeThunk2(
_In_ HPTPROVIDER hProvider,
_In_ BYTE *pPrintTicket,
_In_ ULONG cbSize,
_In_ INT baseType,
_In_ DWORD scope,
_Out_ BYTE **ppDevmode,
_Out_ ULONG *pcbDevModeLength,
_Out_opt_ BSTR *errMsg
);
매개 변수
-
hProvider [in]
-
열려 있는 인쇄 티켓 공급자에 대한 핸들입니다. 이 핸들은 BindPTProviderThunk 함수에 의해 반환됩니다.
-
pPrintTicket [in]
-
변환할 인쇄 티켓이 들어 있는 버퍼입니다.
-
cbSize [in]
-
pPrintTicket에 전달된 버퍼의 크기(바이트)입니다.
-
baseType [in]
-
pPrintTicket에서 DEVMODE에 대해 가능한 모든 설정을 지정하지 않는 경우 사용자의 기본 DEVMODE 또는 인쇄 큐의 기본 DEVMODE가 출력 DEVMODE에 값을 제공하는 데 사용되는지 여부를 나타내는 값입니다. 이 매개 변수의 값은 INT로 캐스팅된 EDefaultDevmodeType 열거형의 멤버여야 합니다.
-
scope [in]
-
pPrintTicket의 scope 지정하는 값입니다. 이 값은 인쇄 작업의 단일 페이지, 전체 문서 또는 모든 문서를 지정할 수 있습니다. 이 매개 변수의 값은 DWORD로 캐스팅된 EPrintTicketScope 열거형의 멤버여야 합니다.
-
ppDevmode [out]
-
새로 만든 DEVMODE의 주소입니다. 이 함수 는 CoTaskMemAlloc 를 호출하여 이 버퍼를 할당합니다. 버퍼가 더 이상 필요하지 않은 경우 호출자는 CoTaskMemFree를 호출하여 버퍼를 해제해야 합니다.
-
pcbDevModeLength [out]
-
ppDevmode에서 반환된 DEVMODE의 크기(바이트)입니다.
-
errMsg [out, optional]
-
pPrintTicket의 인쇄 티켓에 대해 잘못된 항목(있는 경우)을 지정하는 문자열에 대한 포인터입니다. 유효한 경우 NULL입니다. 함수가 반환할 때 errMsg 가 NULL 이 아닌 경우 호출자는 SysFreeString을 사용하여 문자열을 해제해야 합니다.
반환 값
메서드가 성공하면 S_OK 반환합니다. 그렇지 않으면 HRESULT 오류 코드가 반환됩니다. COM 오류 코드에 관한 자세한 내용은 오류 처리를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| DLL |
|