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

Artigo
12/22/2023

Obtém os tipos de segmentos na figura.

Sintaxe

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

Parâmetros

[in, out] segmentCount

O tamanho da matriz referenciada por segmentTypes (veja abaixo). Esse parâmetro não deve ser NULL.

Se o método retornar com êxito, segmentCount conterá o número de elementos retornados na matriz referenciada por segmentTypes.

Se segmentTypes for NULL quando o método for chamado, segmentCount deverá ser definido como zero.

Se um ponteiro NULL for retornado em segmentTypes, o valor de segmentCount conterá o tamanho do buffer necessário, especificado como o número de elementos.

[in, out] segmentTypes

Uma matriz de valores XPS_SEGMENT_TYPE que tem o mesmo número de elementos especificado em segmentCount. Se o chamador exigir que apenas o tamanho do buffer especificado seja retornado, defina esse valor como NULL.

Se a matriz for grande o suficiente, esse método copiará os valores de XPS_SEGMENT_TYPE para a matriz e retornará, em segmentCount, o número dos valores copiados. Se segmentTypes for NULL ou fizer referência a um buffer que não é grande o suficiente, um ponteiro NULL será retornado, nenhum dado será copiado e segmentCount conterá o tamanho do buffer necessário, que é especificado como o número de elementos.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK; caso contrário, ele retornará um código de erro HRESULT .

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	segmentCount é NULL.
ERROR_MORE_DATA	segmentTypes é NULL ou faz referência a um buffer que não é grande o suficiente para receber os dados XPS_SEGMENT_TYPE . segmentCount contém o número necessário de elementos.

Comentários

Para obter um exemplo de como usar esse método em um programa, consulte o exemplo de código em GetSegmentData.

Requisitos


Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	xpsobjectmodel.h