Metodo IXpsOMPackage1::WriteToFile1 (xpsobjectmodel_1.h)

Articolo
08/28/2023

Scrive un file XPS OM in un file come pacchetto XPS di un tipo specificato.

Sintassi

HRESULT WriteToFile1(
  LPCWSTR               fileName,
  LPSECURITY_ATTRIBUTES securityAttributes,
  DWORD                 flagsAndAttributes,
  BOOL                  optimizeMarkupSize,
  XPS_DOCUMENT_TYPE     documentType
);

Parametri

fileName

[in, string] Nome del file da creare. Questo parametro non deve essere NULL.

securityAttributes

[in, univoco] Struttura SECURITY_ATTRIBUTES, che contiene due membri dati distinti ma correlati:

lpSecurityDescriptor: descrittore di sicurezza facoltativo

bInheritHandle: valore booleano che determina se l'handle restituito può essere ereditato dai processi figlio

Se lpSecurityDescriptor è NULL, al file o al dispositivo associato all'handle restituito verrà assegnato un descrittore di sicurezza predefinito.

Per altre informazioni sul parametro securityAttributes, vedere CreateFile.

flagsAndAttributes

[in] Specifica le impostazioni e gli attributi del file da creare. Per la maggior parte dei file, è possibile usare un valore di FILE_ATTRIBUTE_NORMAL.

Per altre informazioni sul parametro flagsAndAttributes, vedere CreateFile.

optimizeMarkupSize

[in] Valore booleano che indica se il markup del documento verrà ottimizzato per le dimensioni quando il contenuto del file XPS OM viene scritto nel pacchetto XPS.

TRUE: il writer di pacchetti tenterà di ottimizzare il markup per le dimensioni minime.

FALSE: il writer di pacchetti non tenterà di eseguire alcuna ottimizzazione.

documentType

[in] Formato di dati XPS da scrivere in outputStream. Il valore di questo parametro non può essere XPS_DOCUMENT_TYPE_UNSPECIFIED.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non solo, i valori seguenti. Per informazioni sui valori restituiti dell'API documento XPS non elencati in questa tabella, vedere Errori del documento XPS.

S_OK: il metodo è riuscito.

E_POINTER: documentType è NULL.

E_INVALIDARG: il tipo di documento è stato specificato come XPS_DOCUMENT_TYPE_UNSPECIFIED.

XPS_E_INVALID_CONTENT_TYPE: una risorsa immagine nel pacchetto è di un tipo non supportato dal tipo di documento specificato in documentType.

Commenti

Il chiamante deve assicurarsi che tutte le risorse immagine nel pacchetto siano supportate dal tipo di pacchetto. Ad esempio, le immagini JpegXR non possono essere usate in un tipo di documento MSXPS perché non sono compatibili.

Requisiti


Client minimo supportato	Windows 8 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	xpsobjectmodel_1.h
Libreria	Nessuno

Vedi anche

IXpsOMPackage1

Condividi tramite