Método IPrintOemPrintTicketProvider::GetSupportedVersions (prcomoem.h)
El método IPrintOemPrintTicketProvider::GetSupportedVersions recupera las versiones principales de los esquemas de impresión admitidos por el proveedor de complementos.
Sintaxis
HRESULT GetSupportedVersions(
[in] HANDLE hPrinter,
[out] INT * [] ppVersions,
[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 los que apunta *ppVersions.
Valor devuelto
IPrintOemPrintTicketProvider::GetSupportedVersions debe devolver S_OK si la operación se realiza correctamente. De lo contrario, este método debe devolver un código de error COM estándar.
Comentarios
IPrintOemPrintTicketProvider::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 no es responsable de liberar esta memoria.
Se puede llamar a IPrintOemPrintTicketProvider::GetSupportedVersions antes de llamar al método IPrintOemPrintTicketProvider::BindPrinter. Como resultado, el proveedor de complementos OEM no debe cerrar el controlador de impresora asociado al parámetro hPrinter .
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | prcomoem.h (include Prcomoem.h) |