Método IXpsOMGeometryFigure::GetSegmentTypes (xpsobjectmodel.h)

Artículo
08/28/2023

Obtiene los tipos de segmentos de la ilustración.

Sintaxis

HRESULT GetSegmentTypes(
  [in, out] UINT32           *segmentCount,
  [in, out] XPS_SEGMENT_TYPE *segmentTypes
);

Parámetros

[in, out] segmentCount

Tamaño de la matriz a la que hace referencia segmentTypes (consulte a continuación). Este parámetro no debe ser NULL.

Si el método devuelve correctamente, segmentCount contendrá el número de elementos devueltos en la matriz a la que hacen referencia segmentTypes.

Si segmentTypes es NULL cuando se llama al método , segmentCount debe establecerse en cero.

Si se devuelve un puntero NULL en segmentTypes, el valor de segmentCount contendrá el tamaño de búfer necesario, especificado como el número de elementos.

[in, out] segmentTypes

Matriz de valores de XPS_SEGMENT_TYPE que tiene el mismo número de elementos que se especifican en segmentCount. Si el autor de la llamada requiere que solo se devuelva el tamaño del búfer especificado, establezca este valor en NULL.

Si la matriz es lo suficientemente grande, este método copiará los valores de XPS_SEGMENT_TYPE en la matriz y devolverá, en segmentCount, el número de los valores copiados. Si segmentTypes es NULL o hace referencia a un búfer que no es lo suficientemente grande, se devolverá un puntero NULL , no se copiará ningún dato y segmentCount contendrá el tamaño de búfer necesario, que se especifica como el número de elementos.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK; de lo contrario, devuelve un código de error HRESULT .

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_POINTER	segmentCount es NULL.
ERROR_MORE_DATA	segmentTypes es NULL o hace referencia a un búfer que no es lo suficientemente grande como para recibir los datos de XPS_SEGMENT_TYPE . segmentCount contiene el número necesario de elementos.

Comentarios

Para obtener un ejemplo de cómo usar este método en un programa, vea el ejemplo de código en GetSegmentData.

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