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 |