IXpsOMPackage1::WriteToFile1-Methode (xpsobjectmodel_1.h)
Schreibt ein XPS OM als XPS-Paket eines angegebenen Typs in eine Datei.
Syntax
HRESULT WriteToFile1(
LPCWSTR fileName,
LPSECURITY_ATTRIBUTES securityAttributes,
DWORD flagsAndAttributes,
BOOL optimizeMarkupSize,
XPS_DOCUMENT_TYPE documentType
);
Parameter
fileName
[in, Zeichenfolge] Der Name der zu erstellenden Datei. Dieser Parameter darf nicht NULL sein.
securityAttributes
[in, eindeutig] Die SECURITY_ATTRIBUTES-Struktur, die zwei unterschiedliche, aber verwandte Datenmber enthält:
lpSecurityDescriptor: ein optionaler Sicherheitsdeskriptor
bInheritHandle: ein boolescher Wert, der bestimmt, ob das zurückgegebene Handle von untergeordneten Prozessen geerbt werden kann.
Wenn lpSecurityDescriptor NULL ist, wird der Datei oder dem Gerät, das dem zurückgegebenen Handle zugeordnet ist, ein Standardsicherheitsdeskriptor zugewiesen.
Weitere Informationen zum securityAttributes-Parameter finden Sie unter CreateFile.
flagsAndAttributes
[in] Gibt die Einstellungen und Attribute der zu erstellenden Datei an. Für die meisten Dateien kann der Wert FILE_ATTRIBUTE_NORMAL verwendet werden.
Weitere Informationen zum FlagsAndAttributes-Parameter finden Sie unter CreateFile.
optimizeMarkupSize
[in] Ein boolescher Wert, der angibt, ob das Dokumentmarkup für die Größe optimiert wird, wenn der Inhalt des XPS OM in das XPS-Paket geschrieben wird.
TRUE: Der Paketschreiber versucht, das Markup für die Mindestgröße zu optimieren.
FALSE: Der Paketschreiber versucht nicht, eine Optimierung durchzuführen.
documentType
[in] Das XPS-Datenformat, das in outputStream geschrieben werden soll. Der Wert dieses Parameters kann nicht XPS_DOCUMENT_TYPE_UNSPECIFIED werden.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem die folgenden Werte. Informationen zu Rückgabewerten der XPS-Dokument-API, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS-Dokumentfehler.
S_OK: Die Methode war erfolgreich.
E_POINTER: documentType ist NULL.
E_INVALIDARG: Der Dokumenttyp wurde als XPS_DOCUMENT_TYPE_UNSPECIFIED angegeben.
XPS_E_INVALID_CONTENT_TYPE: Eine Bildressource im Paket weist einen Typ auf, der von dem in documentType angegebenen Dokumenttyp nicht unterstützt wird.
Hinweise
Der Aufrufer muss sicherstellen, dass alle Imageressourcen im Paket vom Pakettyp unterstützt werden. JpegXR-Bilder können beispielsweise nicht in einem MSXPS-Dokumenttyp verwendet werden, da sie nicht kompatibel sind.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | xpsobjectmodel_1.h |
| Bibliothek | Keine |