[이 함수는 지원되지 않으며 이후 버전의 Windows에서 사용하지 않도록 설정되거나 삭제될 수 있습니다. PTGetPrintCapabilities 는 동등한 기능을 제공하며 대신 사용해야 합니다.]
XML 인쇄 스키마에 따라 서식이 지정된 프린터의 기능을 검색합니다.
구문
HRESULT GetPrintCapabilitiesThunk2(
_In_ HPTPROVIDER hProvider,
_In_ BYTE *pPrintTicket,
_In_ INT cbPrintTicket,
_Out_ BYTE **ppbPrintCapabilities,
_Out_ INT *pcbPrintCapabilitiesLength,
_Out_opt_ BSTR *pbstrErrorMessage
);
매개 변수
-
hProvider [in]
-
열려 있는 인쇄 티켓 공급자에 대한 핸들입니다. 이 핸들은 BindPTProviderThunk 함수에 의해 반환됩니다.
-
pPrintTicket [in]
-
인쇄 스키마에 설명된 대로 XML로 표현된 인쇄 티켓 데이터가 포함된 버퍼입니다.
-
cbPrintTicket [in]
-
pPrintTicket에서 참조하는 버퍼의 크기(바이트)입니다.
-
ppbPrintCapabilities [out]
-
이 함수에 의해 할당되고 XML로 인코딩된 유효한 인쇄 기능 정보를 포함하는 버퍼의 주소입니다. 이 함수 는 CoTaskMemAlloc 를 호출하여 이 버퍼를 할당합니다. 버퍼가 더 이상 필요하지 않은 경우 호출자는 CoTaskMemFree를 호출하여 버퍼를 해제해야 합니다.
-
pcbPrintCapabilitiesLength [out]
-
ppbPrintCapabilities에서 참조하는 버퍼의 크기(바이트)입니다.
-
pbstrErrorMessage [out, optional]
-
pPrintTicket에 대해 잘못된 항목을 지정하는 문자열에 대한 포인터입니다. 유효한 경우 이 값은 NULL입니다. 함수가 반환되면 pbstrErrorMessage 가 NULL 이 아니면 호출자는 SysFreeString을 사용하여 문자열을 해제해야 합니다.
반환 값
메서드가 성공하면 S_OK 반환합니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다. COM 오류 코드에 관한 자세한 내용은 오류 처리를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| DLL |
|