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)

Consulte también

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::BindPrinter