Share via

IAppxManifestApplication::GetStringValue 메서드(appxpackaging.h)

  • 아티클

매니페스트의 애플리케이션 메타데이터 섹션에서 요소 또는 특성의 문자열 값을 가져옵니다.

구문

HRESULT GetStringValue(
  [in]          LPCWSTR name,
  [out, retval] LPWSTR  *value
);

매개 변수

[in] name

형식: LPCWSTR

애플리케이션 메타데이터에서 가져올 요소 또는 특성 값의 이름입니다. 지원되는 이름은 다음과 같습니다.

  • AppListEntry
  • BackgroundColor
  • Defaultsize
  • Description
  • DisplayName
  • EntryPoint
  • 실행 파일
  • ForegroundText
  • ID
  • LockScreenLogo
  • LockScreenNotification
  • 로고
  • Minwidth
  • ShortName
  • SmallLogo
  • Square150x150Logo
  • Square30x30Logo
  • Square310x310Logo
  • Square44x44Logo
  • Square70x70Logo
  • Square71x71Logo
  • StartPage
  • Tall150x310Logo
  • VisualGroup
  • WideLogo
  • Wide310x150Logo

매니페스트에서 이러한 값을 읽는 위치를 확인하려면 스키마 를 참조하세요.

[out, retval] value

형식: LPWSTR*

요청된 요소 또는 특성의 값입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

name 매개 변수가 매니페스트에 있는 요소 또는 특성의 지원되는 이름이 아니면 이 메서드는 E_INVALIDARG 반환합니다. name 매개 변수가 지원되지만 매니페스트에서 요소 또는 특성을 찾을 수 없는 경우 이 메서드는 S_OK 반환하고 값 매개 변수의 반환 값은 NULL입니다.

호출자는 CoTaskMemFree 함수를 사용하여 값에 할당된 메모리를 해제해야 합니다.

예제

예제는 빠른 시작: 앱 패키지 매니페스트 정보 읽기를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 appxpackaging.h

추가 정보

IAppxManifestApplication