Método IPrintTicketProvider2::GetSupportedVersions (prdrvcom.h)
El método IPrintTicketProvider2::GetSupportedVersions recupera los números de versión principales de los esquemas de impresión admitidos por el proveedor de complementos.
Sintaxis
HRESULT GetSupportedVersions(
[in] IN HANDLE hPrinter,
[out] OUT INT * [] ppVersions,
[out] OUT INT *cVersions
);
Parámetros
[in] hPrinter
Identificador del dispositivo de impresión.
[out] ppVersions
Puntero a una variable que recibe la dirección del primer elemento de una matriz de números de versión. Los números de versión de la matriz pueden aparecer en cualquier orden. Para obtener más información sobre este parámetro, vea la siguiente sección Comentarios.
[out] cVersions
Puntero a una variable que recibe el número de elementos de la matriz a la que apunta ppVersions.
Valor devuelto
IPrintTicketProvider2::GetSupportedVersions debe devolver S_OK si la operación se realiza correctamente. Si se produce un error en este método debido a la falta de memoria u otros recursos, debe devolver un código de error COM estándar.
Comentarios
IPrintTicketProvider2::GetSupportedVersions devuelve los números de versión principales de los esquemas de impresión admitidos por la interfaz del proveedor. El único número de versión definido actualmente es 1. Los proveedores pueden omitir versiones intermedias.
El complemento es responsable de asignar la memoria de matriz a la que apunta el parámetro ppVersions . El complemento debe asignar esta memoria mediante la función CoTaskMemAlloc descrita en la documentación de Microsoft Windows SDK, pero el complemento no es responsable de liberar esta memoria.
Dado que se puede llamar a IPrintTicketProvider2::GetSupportedVersions antes de llamar al método IPrintTicketProvider2::BindPrinter , el proveedor de complementos OEM debe comprobar la compatibilidad con la versión en función del identificador que se pasa en el parámetro hPrinter . Como resultado, el proveedor de complementos OEM no debe cerrar el controlador de impresora asociado a hPrinter.
Requisitos
| Requisito | Valor |
|---|---|
| Header | prdrvcom.h (incluya Prdrvcom.h) |