Metodo IXpsOMGeometryFigure::GetSegmentTypes (xpsobjectmodel.h)

Articolo
08/28/2023

Ottiene i tipi di segmenti nella figura.

Sintassi

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

Parametri

[in, out] segmentCount

Dimensioni della matrice a cui fa riferimento segmentTypes (vedere di seguito). Questo parametro non deve essere NULL.

Se il metodo restituisce correttamente, segmentCount conterrà il numero di elementi restituiti nella matrice a cui fa riferimento segmentTypes.

Se segmentTypes è NULL quando viene chiamato il metodo, segmentCount deve essere impostato su zero.

Se viene restituito un puntatore NULL in segmentTypes, il valore di segmentCount conterrà le dimensioni del buffer necessarie, specificate come numero di elementi.

[in, out] segmentTypes

Matrice di valori XPS_SEGMENT_TYPE con lo stesso numero di elementi specificati in segmentCount. Se il chiamante richiede che venga restituita solo la dimensione del buffer specificata, impostare questo valore su NULL.

Se la matrice è abbastanza grande, questo metodo copia i valori di XPS_SEGMENT_TYPE nella matrice e restituisce, in segmentCount, il numero dei valori copiati. Se segmentTypes è NULL o fa riferimento a un buffer che non è abbastanza grande, verrà restituito un puntatore NULL , non verranno copiati dati e segmentCount conterrà le dimensioni del buffer necessarie, che viene specificato come numero di elementi.

Valore restituito

Se il metodo ha esito positivo, restituisce S_OK; in caso contrario, restituisce un codice di errore HRESULT .

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	segmentCount è NULL.
ERROR_MORE_DATA	segmentTypes è NULL o fa riferimento a un buffer che non è abbastanza grande per ricevere i dati XPS_SEGMENT_TYPE . segmentCount contiene il numero necessario di elementi.

Commenti

Per un esempio di come usare questo metodo in un programma, vedere l'esempio di codice in GetSegmentData.

Requisiti


Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	xpsobjectmodel.h