GetSupportedVersions

Importante

A plataforma de impressão moderna é o meio preferencial do Windows para se comunicar com as impressoras. Recomendamos que você use o driver de classe de caixa de entrada IPP da Microsoft juntamente com PSA (Aplicativos de Suporte à Impressão) para personalizar a experiência de impressão no Windows 10 e 11 para o desenvolvimento de dispositivos de impressora.

Para obter mais informações, consulte Plataformade impressão moderna e o Guia de design do aplicativo de suporte de impressão.

O método IPrintTicketProvider::GetSupportedVersions retorna os números de versão principais dos Esquemas de Impressão compatíveis com o driver de impressão. Por enquanto, a versão 1 é a única versão que existe, portanto, esse método deve retornar apenas uma versão compatível.

A implementação exibida no exemplo de código a seguir funcionará para a versão inicial do Windows Vista e até que uma nova versão seja adicionada. Quando uma nova versão for compatível, esse valor será alterado.

STDMETHODIMP 
CPrintTicketProvider::
GetSupportedVersions(THIS_ HANDLE hPrinter,
                           INT *ppVersions[],
                           INT *pcVersions)
{
    if ( (*ppVersions = (INT*)CoTaskMemAlloc(sizeof(INT))) != NULL)
    {
         (*ppVersions)[0] = 1;  // Version 1
        *pcVersions = 1; // 1 supported version
        return S_OK;
    }
    else
        return E_OUTOFMEMORY;
}