Método IXpsOMObjectFactory::CreateDocumentStructureResource (xpsobjectmodel.h)

Artículo
03/15/2023

Crea una interfaz IXpsOMDocumentStructureResource , que proporciona acceso al flujo de recursos de estructura de documentos.

Sintaxis

HRESULT CreateDocumentStructureResource(
  [in]          IStream                         *acquiredStream,
  [in]          IOpcPartUri                     *partUri,
  [out, retval] IXpsOMDocumentStructureResource **documentStructureResource
);

Parámetros

[in] acquiredStream

Interfaz IStream de solo lectura que se va a asociar a este recurso. Este parámetro no debe ser NULL.

Importante Trate esta secuencia como un objeto Single-Threaded Apartment (STA); no vuelva a escribirlo.

[in] partUri

Interfaz IOpcPartUri que contiene el nombre del elemento que se va a asignar a este recurso. Este parámetro no debe ser NULL.

[out, retval] documentStructureResource

Puntero a la nueva interfaz IXpsOMDocumentStructureResource .

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente. Para obtener información sobre los valores devueltos de la API de documentos XPS que no aparecen en esta tabla, vea Errores del documento XPS.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_POINTER	acquiredStream, partUri o documentStructureResource es NULL.

Comentarios

La parte DocumentStructure de un documento XPS contiene el esquema del documento, que, con las partes StoryFragments, define el orden de lectura de cada elemento que aparece en las páginas fijas del documento. Esta interfaz permite a un programa leer el contenido XML del elemento DocumentStructure y reemplazar también el contenido XML del elemento DocumentStructure.

El elemento DocumentStructure contiene el marco de documentos y el esquema que describe el orden de lectura general del documento. El orden de lectura se organiza en bloques semánticos denominados historias. Las historias son unidades lógicas del documento de la misma manera que los artículos son unidades en una revista. Las historias se componen de una o varias partes de StoryFragments.

Los elementos StoryFragments contienen marcado de estructura de contenido que define los bloques semánticos de la historia, como los párrafos y las tablas que componen el contenido del artículo.

El contenido de los elementos DocumentStructure y StoryFragments se describe en la Especificación de papel XML.

Requisitos


Cliente mínimo compatible	Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	xpsobjectmodel.h