IAppxManifestApplication::GetStringValue 方法 (appxpackaging.h)
取得指令清單之應用程式元數據區段中專案或屬性的字串值。
語法
HRESULT GetStringValue(
[in] LPCWSTR name,
[out, retval] LPWSTR *value
);
參數
[in] name
類型: LPCWSTR
要從應用程式元數據取得的專案或屬性值名稱。 支援的名稱包括:
- AppListEntry
- BackgroundColor
- DefaultSize
- 描述
- DisplayName
- EntryPoint
- 可執行檔
- ForegroundText
- 識別碼
- 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 |