Método IXpsOMPackage1::WriteToFile1 (xpsobjectmodel_1.h)
Escribe un OM XPS en un archivo como un paquete XPS de un tipo especificado.
Sintaxis
HRESULT WriteToFile1(
LPCWSTR fileName,
LPSECURITY_ATTRIBUTES securityAttributes,
DWORD flagsAndAttributes,
BOOL optimizeMarkupSize,
XPS_DOCUMENT_TYPE documentType
);
Parámetros
fileName
[in, string] Nombre del archivo que se va a crear. Este parámetro no debe ser NULL.
securityAttributes
[in, unique] Estructura SECURITY_ATTRIBUTES, que contiene dos miembros de datos distintos 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 asignará un descriptor de seguridad predeterminado.
Para obtener más información sobre el parámetro securityAttributes, consulte 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 un valor de FILE_ATTRIBUTE_NORMAL.
Para obtener más información sobre el parámetro flagsAndAttributes, consulte CreateFile.
optimizeMarkupSize
[in] Valor booleano que indica si el marcado de documento se optimizará para el tamaño cuando el contenido del XPS OM se escriba en el paquete XPS.
TRUE: el escritor de paquetes intentará optimizar el marcado para el tamaño mínimo.
FALSE: el escritor de paquetes no intentará realizar ninguna optimización.
documentType
[in] Formato de datos XPS que se va a escribir en outputStream. El valor de este parámetro no puede ser XPS_DOCUMENT_TYPE_UNSPECIFIED.
Valor devuelto
El método devuelve un valor HRESULT. Entre los valores posibles se incluyen, entre otros, los siguientes valores. Para obtener información sobre los valores devueltos de XPS Document API que no aparecen en esta tabla, vea Errores de documento XPS.
S_OK: el método se realizó correctamente.
E_POINTER: documentType es NULL.
E_INVALIDARG: el tipo de documento se especificó como XPS_DOCUMENT_TYPE_UNSPECIFIED.
XPS_E_INVALID_CONTENT_TYPE: un recurso de imagen del paquete es de un tipo que no es compatible con el tipo de documento especificado en documentType.
Observaciones
El autor de la llamada debe asegurarse de que todos los recursos de imagen del paquete son compatibles con el tipo de paquete. Por ejemplo, las imágenes JpegXR no se pueden usar en un tipo de documento MSXPS porque son incompatibles.
Requisitos
| Cliente mínimo compatible | Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | xpsobjectmodel_1.h |
| Library | None |