IXpsOMGeometryFigure::GetSegmentTypes-Methode (xpsobjectmodel.h)

Artikel
12/22/2023

Ruft die Typen von Segmenten in der Abbildung ab.

Syntax

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

Parameter

[in, out] segmentCount

Die Größe des Arrays, auf das von segmentTypes verwiesen wird (siehe unten). Dieser Parameter darf nicht NULL sein.

Wenn die Methode erfolgreich zurückgibt, enthält segmentCount die Anzahl der Elemente, die in dem Array zurückgegeben werden, auf das von segmentTypes verwiesen wird.

Wenn segmentTypesnull ist, wenn die Methode aufgerufen wird, muss segmentCount auf 0 festgelegt werden.

Wenn ein NULL-Zeiger in segmentTypes zurückgegeben wird, enthält der Wert von segmentCount die erforderliche Puffergröße, die als Anzahl von Elementen angegeben ist.

[in, out] segmentTypes

Ein Array von XPS_SEGMENT_TYPE Werten, die die gleiche Anzahl von Elementen wie in segmentCount angegeben haben. Wenn der Aufrufer erfordert, dass nur die angegebene Puffergröße zurückgegeben wird, legen Sie diesen Wert auf NULL fest.

Wenn das Array groß genug ist, kopiert diese Methode die XPS_SEGMENT_TYPE Werte in das Array und gibt in segmentCount die Anzahl der kopierten Werte zurück. Wenn segmentTypesNULL ist oder auf einen Puffer verweist, der nicht groß genug ist, wird ein NULL-Zeiger zurückgegeben, es werden keine Daten kopiert, und segmentCount enthält die erforderliche Puffergröße, die als Anzahl von Elementen angegeben wird.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Rückgabecode	Beschreibung
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	segmentCount ist NULL.
ERROR_MORE_DATA	segmentTypes ist NULL oder verweist auf einen Puffer, der nicht groß genug ist, um die XPS_SEGMENT_TYPE Daten zu empfangen. segmentCount enthält die erforderliche Anzahl von Elementen.

Hinweise

Ein Beispiel für die Verwendung dieser Methode in einem Programm finden Sie im Codebeispiel in GetSegmentData.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	xpsobjectmodel.h