Metodo IXpsOMObjectFactory1::CreatePackageWriterOnFile1 (xpsobjectmodel_1.h)

Articolo
08/28/2023

Apre un file per scrivere il 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: descrittore di sicurezza facoltativo
bInheritHandle: valore booleano che determina se l'handle restituito può essere ereditato dai processi figlio

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

Per altre informazioni sulla sicurezzaAttributes, 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 dell'OM XPS viene scritto nel pacchetto XPS.

Valore	Significato
VERO	Il writer del pacchetto tenterà di ottimizzare il markup per le dimensioni minime.
FALSE	Il writer del pacchetto non tenterà di eseguire alcuna ottimizzazione.

interleaving

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

documentSequencePartName

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

coreProperties

[in] Interfaccia IXpsOMCoreProperties che contiene le proprietà del documento di base 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 contenente il ticket di stampa a livello di pacchetto da assegnare al nuovo file. Questo parametro può essere impostato su NULL.

discardControlPartName

[in] Interfaccia IOpcPartUri contenente il nome della parte di controllo di eliminazione. 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 sono limitati ai seguenti. Per informazioni sui valori restituiti dall'API documento XPS non elencati qui, vedere 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.

Commenti

Usare 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

Requisiti

Requisito	Valore
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

IXpsOMObjectFactory1

Condividi tramite