Compartir a través de

Método IXpsOMObjectFactory1::CreatePackageWriterOnFile1 (xpsobjectmodel_1.h)

  • Artículo

Abre un archivo para escribir el contenido de un OM XPS en un paquete XPS de un tipo especificado. Este método genera un escritor de paquetes para un documento MSXPS o un documento OpenXPS.

Sintaxis

HRESULT CreatePackageWriterOnFile1(
  LPCWSTR                   fileName,
  LPSECURITY_ATTRIBUTES     securityAttributes,
  DWORD                     flagsAndAttributes,
  BOOL                      optimizeMarkupSize,
  XPS_INTERLEAVING          interleaving,
  IOpcPartUri               *documentSequencePartName,
  IXpsOMCoreProperties      *coreProperties,
  IXpsOMImageResource       *packageThumbnail,
  IXpsOMPrintTicketResource *documentSequencePrintTicket,
  IOpcPartUri               *discardControlPartName,
  XPS_DOCUMENT_TYPE         documentType,
  IXpsOMPackageWriter       **packageWriter
);

Parámetros

fileName

[in] Nombre del archivo que se va a crear.

securityAttributes

[in, unique] La estructura SECURITY_ATTRIBUTES, que contiene dos miembros independientes pero relacionados:

  • lpSecurityDescriptor: un descriptor de seguridad opcional
  • bInheritHandle: un valor booleano que determina si los procesos secundarios pueden heredar el identificador devuelto.
Si lpSecurityDescriptor es NULL, al archivo o dispositivo asociado al identificador devuelto se le asigna un descriptor de seguridad predeterminado.

Para obtener más información sobre securityAttributes, vea CreateFile.

flagsAndAttributes

[in] Especifica la configuración y los atributos del archivo que se van a crear. Para la mayoría de los archivos, se puede usar el valor de FILE_ATTRIBUTE_NORMAL.

Consulte CreateFile para obtener más información sobre este parámetro.

optimizeMarkupSize

[in] Valor booleano que indica si el marcado del documento se optimizará para el tamaño cuando el contenido del OM XPS se escriba en el paquete XPS.

Valor Significado
TRUE
 El escritor de paquetes intentará optimizar el marcado para un tamaño mínimo.
false
 El escritor de paquetes no intentará realizar ninguna optimización.

interleaving

[in] Especifica si el contenido del OM XPS se intercalará cuando se escriba en el archivo.

documentSequencePartName

[in] La interfaz IOpcPartUri que contiene el nombre de parte de la secuencia del documento en el nuevo archivo.

coreProperties

[in] La interfaz IXpsOMCoreProperties que contiene las propiedades principales del documento que se van a proporcionar al nuevo archivo. Este parámetro se puede establecer en NULL.

packageThumbnail

[in] La interfaz IXpsOMImageResource que contiene la imagen en miniatura que se va a asignar al nuevo archivo. Este parámetro se puede establecer en NULL.

documentSequencePrintTicket

[in] La interfaz IXpsOMPrintTicketResource que contiene el vale de impresión de nivel de paquete que se asignará al nuevo archivo. Este parámetro se puede establecer en NULL.

discardControlPartName

[in] La interfaz IOpcPartUri que contiene el nombre de la parte de control de descarte. Este parámetro se puede establecer en NULL.

documentType

[in] Especifica el tipo de documento del escritor de paquetes. El valor de este parámetro no puede ser XPS_DOCUMENT_TYPE_UNSPECIFIED.

packageWriter

[out, retval] Puntero a la nueva interfaz IXpsOMPackageWriter creada por este método.

Valor devuelto

Entre los valores posibles se incluyen, entre otros, los siguientes. Para obtener información sobre los valores devueltos de la API de documentos XPS que no aparecen aquí, consulte Errores del documento XPS.

S_OK: el método se realizó correctamente y packageWriter se estableció correctamente.

E_INVALIDARG: el tipo de documento no era un formato de documento XPS válido.

Observaciones

Use este método para generar un escritor de paquetes para un documento MSXPS o un documento OpenXPS. CreatePackageWriterOnFile, publicado en Windows 7, solo crea archivos de documento XPS en el formato MSXPS.

referencias adicionales

Referencias adicionales: descripción del método heredado

Requisitos

Requisito Valor
cliente mínimo admitido Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
servidor mínimo admitido Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de Windows
encabezado de xpsobjectmodel_1.h
biblioteca de Ninguno

Consulte también

IXpsOMObjectFactory1