Compartir a través de


Método IPrintOemPrintTicketProvider::GetSupportedVersions (prcomoem.h)

El método IPrintOemPrintTicketProvider::GetSupportedVersions recupera las versiones principales de los esquemas de impresión compatibles con 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 la 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.

Observaciones

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 (que se describe en la documentación del SDK de Microsoft Windows), pero no es responsable de liberar esta memoria.

se puede llamar a IPrintOemPrintTicketProvider::GetSupportedVersion s antes de llamar al método IPrintOemPrintTicketProvider::BindPrinter. Como resultado, el proveedor del complemento OEM no debe cerrar el controlador de impresora asociado al parámetro hPrinter.

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de prcomoem.h (include Prcomoem.h)

Consulte también

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::BindPrinter