IAppxManifestApplication::GetStringValue メソッド (appxpackaging.h)

マニフェストのアプリケーション メタデータ セクションの要素または属性の文字列値を取得します。

構文

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

パラメーター

[in] name

種類: LPCWSTR

アプリケーション メタデータから取得する要素または属性値の名前。 サポートされている名前は次のとおりです。

  • AppListEntry
  • BackgroundColor
  • DefaultSize
  • 説明
  • 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を返し、value パラメーターの戻り値は NULL です

呼び出し元は、CoTaskMemFree 関数を使用して、値に割り当てられたメモリを解放する必要があります。

例については、「 クイック スタート: アプリ パッケージ マニフェスト情報の読み取り」を参照してください。

要件

要件
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー appxpackaging.h

こちらもご覧ください

IAppxManifestApplication