Metodo IXpsOMObjectFactory1::CreatePackageWriterOnFile1 (xpsobjectmodel_1.h)

Articolo
11/20/2024

Apre un file per la scrittura del contenuto di un XPS OM in un pacchetto XPS di un tipo specificato. Questo metodo produce un writer di pacchetti per un documento MSXPS o un documento OpenXPS.

Sintassi

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
);

Parametri

fileName

[in] Nome del file da creare.

securityAttributes

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

lpSecurityDescriptor: un 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 viene assegnato un descrittore di sicurezza predefinito.

Per altre informazioni su securityAttributes, vedere CreateFile.

flagsAndAttributes

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

Per altre informazioni su questo parametro, vedere CreateFile.

optimizeMarkupSize

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

Valore	Significato
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.

interleaving

[in] Specifica se il contenuto di XPS OM verrà interleavedato quando viene scritto nel file.

documentSequencePartName

[in] Interfaccia IOpcPartUri che contiene il nome della parte della sequenza di documenti nel nuovo file.

coreProperties

[in] L'interfaccia IXpsOMCoreProperties che contiene le proprietà principali del documento da assegnare al nuovo file. Questo parametro può essere impostato su NULL.

packageThumbnail

[in] Interfaccia IXpsOMImageResource che contiene l'immagine di anteprima da assegnare al nuovo file. Questo parametro può essere impostato su NULL.

documentSequencePrintTicket

[in] Interfaccia IXpsOMPrintTicketResource che contiene il ticket di stampa a livello di pacchetto da assegnare al nuovo file. Questo parametro può essere impostato su NULL.

discardControlPartName

[in] Interfaccia IOpcPartUri che contiene il nome della parte del controllo discard. Questo parametro può essere impostato su NULL.

documentType

[in] Specifica il tipo di documento del writer del pacchetto. Il valore di questo parametro non può essere XPS_DOCUMENT_TYPE_UNSPECIFIED.

packageWriter

[out, retval] Puntatore alla nuova interfaccia IXpsOMPackageWriter creata da questo metodo.

Valore restituito

I valori possibili includono, ma non solo, quanto segue. Per informazioni sui valori restituiti dell'API documento XPS non elencati qui, vedere XPS Document Errors( Errori del documento XPS).

S_OK: il metodo ha avuto esito positivo e packageWriter è stato impostato correttamente.

E_INVALIDARG: il tipo di documento non era un formato di documento XPS valido.

Osservazioni

Utilizzare questo metodo per produrre un writer di pacchetti per un documento MSXPS o un documento OpenXPS. CreatePackageWriterOnFile, rilasciato in Windows 7, crea solo file di documento XPS nel formato MSXPS.

riferimenti aggiuntivi

Riferimenti aggiuntivi: descrizione del metodo legacy

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 8 [app desktop \| App UWP]
server minimo supportato	Windows Server 2012 [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	xpsobjectmodel_1.h
libreria	Nessuno

Vedere anche

IXpsOMObjectFactory1

Condividi tramite