Función ConvertPrintTicketToDevModeThunk2

[Esta función no se admite y puede deshabilitarse o eliminarse en versiones futuras de Windows. PTConvertPrintTicketToDevMode proporciona una funcionalidad equivalente y debe usarse en su lugar.]

Convierte un vale de impresión en una estructura DEVMODE .

Sintaxis

HRESULT ConvertPrintTicketToDevModeThunk2(
  _In_      HPTPROVIDER hProvider,
  _In_      BYTE        *pPrintTicket,
  _In_      ULONG       cbSize,
  _In_      INT         baseType,
  _In_      DWORD       scope,
  _Out_     BYTE        **ppDevmode,
  _Out_     ULONG       *pcbDevModeLength,
  _Out_opt_ BSTR        *errMsg
);

Parámetros

hProvider [in]

Identificador de un proveedor de vales de impresión abierto. La función BindPTProviderThunk devuelve este identificador.

pPrintTicket [in]

Búfer que contiene el vale de impresión que se va a convertir.

cbSize [in]

Tamaño, en bytes, del búfer pasado en pPrintTicket.

baseType [in]

Valor que indica si el DEVMODE predeterminado del usuario o el DEVMODE predeterminado de la cola de impresión se usa para proporcionar valores al DEVMODE de salida cuando pPrintTicket no especifica todas las opciones posibles para un DEVMODE. El valor de este parámetro debe ser miembro de la enumeración EDefaultDevmodeType , que se convierte como INT.

ámbito [in]

Valor que especifica el ámbito de pPrintTicket. Este valor puede especificar una sola página, un documento completo o todos los documentos del trabajo de impresión. El valor de este parámetro debe ser miembro de la enumeración EPrintTicketScope , que se convierte como DWORD.

ppDevmode [out]

Dirección del DEVMODE recién creado. Esta función llama a CoTaskMemAlloc para asignar este búfer. Cuando el búfer ya no es necesario, el autor de la llamada debe liberarlo llamando a CoTaskMemFree.

pcbDevModeLength [out]

Tamaño, en bytes, del DEVMODE devuelto en ppDevmode.

errMsg [out, optional]

Puntero a una cadena que especifica qué, si hay algo, no es válido sobre el vale de impresión en pPrintTicket. Si es válido, es NULL. Si errMsg no es NULL cuando la función devuelve, el autor de la llamada debe liberar la cadena con SysFreeString.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK; de lo contrario, devuelve un código de error HRESULT . Para obtener más información sobre los códigos de error COM, vea Control de errores.

Requisitos

Consulte también

Esquema de impresión

PTConvertPrintTicketToDevMode

Impresión

Funciones de la API del administrador de trabajos de impresión