Funzione GetPrintCapabilitiesThunk2

[Questa funzione non è supportata e potrebbe essere disabilitata o eliminata nelle versioni future di Windows. PTGetPrintCapabilities offre funzionalità equivalenti e deve essere invece usata.]

Recupera le funzionalità della stampante formattate in conformità allo schema di stampa XML.

Sintassi

HRESULT GetPrintCapabilitiesThunk2(
  _In_      HPTPROVIDER hProvider,
  _In_      BYTE        *pPrintTicket,
  _In_      INT         cbPrintTicket,
  _Out_     BYTE        **ppbPrintCapabilities,
  _Out_     INT         *pcbPrintCapabilitiesLength,
  _Out_opt_ BSTR        *pbstrErrorMessage
);

Parametri

hProvider [in]

Handle per un provider di ticket di stampa aperto. Questo handle viene restituito dalla funzione BindPTProviderThunk .

pPrintTicket [in]

Buffer contenente i dati del ticket di stampa, espressi in XML, come descritto nello schema di stampa.

cbPrintTicket [in]

Dimensione, in byte, del buffer a cui fa riferimento pPrintTicket.

ppbPrintCapabilities [out]

Indirizzo del buffer allocato da questa funzione e contiene le informazioni sulle funzionalità di stampa valide, codificate come XML. Questa funzione chiama CoTaskMemAlloc per allocare questo buffer. Quando il buffer non è più necessario, il chiamante deve liberarlo chiamando CoTaskMemFree.

pcbPrintCapabilitiesLength [out]

Dimensioni, in byte, del buffer a cui fa riferimento ppbPrintCapabilities.

pbstrErrorMessage [out, facoltativo]

Puntatore a una stringa che specifica cosa, se qualcosa, non è valido su pPrintTicket. Se è valido, questo valore è NULL. Se pbstrErrorMessage non è NULL quando la funzione viene restituita, il chiamante deve liberare la stringa con SysFreeString.

Valore restituito

Se il metodo ha esito positivo, restituisce S_OK; in caso contrario, restituisce un codice di errore HRESULT . Per altre informazioni sui codici di errore COM, vedere Gestione degli errori.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
DLL	Prntvpt.dll

Vedi anche

PTGetPrintCapabilities

Stampa schema

Stampa

Funzioni dell'API spooler di stampa