IXpsOMGeometryFigure::GetSegmentTypes 메서드(xpsobjectmodel.h)

아티클
08/28/2023

그림의 세그먼트 형식을 가져옵니다.

구문

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

매개 변수

[in, out] segmentCount

segmentTypes에서 참조하는 배열의 크기입니다(아래 참조). 이 매개 변수는 NULL이 아니어야 합니다.

메서드가 성공적으로 반환되면 segmentCount 는 segmentTypes에서 참조하는 배열에 반환되는 요소 수를 포함합니다.

메서드가 호출될 때 segmentTypes 가 NULL 이면 segmentCount 를 0으로 설정해야 합니다.

segmentTypes에 NULL 포인터가 반환되면 segmentCount 값에 요소 수로 지정된 필요한 버퍼 크기가 포함됩니다.

[in, out] segmentTypes

segmentCount에 지정된 것과 동일한 수의 요소를 포함하는 XPS_SEGMENT_TYPE 값의 배열입니다. 호출자가 지정된 버퍼 크기만 반환해야 하는 경우 이 값을 NULL로 설정합니다.

배열이 충분히 크면 이 메서드는 XPS_SEGMENT_TYPE 값을 배열에 복사하고 segmentCount에서 복사된 값의 수를 반환합니다. segmentTypes가 NULL이거나 충분히 크지 않은 버퍼를 참조하는 경우 NULL 포인터가 반환되고 데이터가 복사되지 않으며 segmentCount에는 요소 수로 지정된 필수 버퍼 크기가 포함됩니다.

반환 값

메서드가 성공하면 S_OK 반환합니다. 그렇지 않으면 HRESULT 오류 코드가 반환됩니다.

반환 코드	설명
S_OK	메서드가 성공했습니다.
E_POINTER	segmentCount 는 NULL입니다.
ERROR_MORE_DATA	segmentTypes 는 NULL 이거나 XPS_SEGMENT_TYPE 데이터를 받을 만큼 크지 않은 버퍼를 참조합니다. segmentCount 에는 필요한 요소 수가 포함됩니다.

설명

프로그램에서 이 메서드를 사용하는 방법에 대한 예제는 GetSegmentData의 코드 예제를 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트가 포함된 Windows Vista [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	xpsobjectmodel.h