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

이 페이지의 Name 속성을 설정합니다.

구문

HRESULT SetName(
  [in] LPCWSTR name
);

[in] name

페이지의 Name 속성으로 설정할 이름 문자열에 대한 포인터입니다. NULL 포인터는 이전에 할당된 이름을 지웁니다.

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

반환 코드	Description
S_OK	메서드가 성공했습니다.
XPS_E_INVALID_NAME	이름 문자열에는 유효하지 않은 문자가 포함되어 있습니다.

Name 속성은 현재 페이지를 문서의 명명된 주소 지정 가능 지점으로 식별하여 하이퍼링크에서 페이지를 참조할 수 있도록 합니다.

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