IXpsOMVisual::SetName 메서드(xpsobjectmodel.h)

시각적 개체의 Name 속성을 설정합니다.

구문

HRESULT SetName(
  [in] LPCWSTR name
);

매개 변수

[in] name

시각적 개체의 이름입니다. NULL 포인터는 Name 속성을 지웁니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값은 다음 표에 있는 값을 포함하지만 이에 국한되지 않습니다. 이 표에 나열되지 않은 XPS 문서 API 반환 값에 대한 자세한 내용은 XPS 문서 오류를 참조하세요.

반환 코드 설명
S_OK
메서드가 성공했습니다.
XPS_E_INVALID_NAME
XML 용지 사양에 따라 이름에 전달된 문자열은 유효한 이름이 아닙니다.

설명

이름은 고유해야 합니다.

이름NULL 포인터를 전달하여 Name 속성을 지우면 IsHyperlinkTarget 속성이FALSE로 설정됩니다.

요구 사항

   
지원되는 최소 클라이언트 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

추가 정보

IXpsOMVisual

XML Paper Specification

XPS 문서 오류