跳轉到主要內容

IXtfConsoleControlClient::GetConfigValue

取得指定組態設定的值。

語法

參數

pszKey
類型:LPCWSTR
指向要取得其值之組態設定名稱的指標。 pszValue
類型:LPBSTR
接收 pszKey 中所指定組態設定之值的指標。

傳回值

類型:HRESULT 如果成功,則傳回 S_OK;否則傳回 HRESULT 錯誤碼。

備註

此函式會從目前的開發主機傳回單一組態設定的值。如果 pszKey 設定為指向包含有效組態設定名稱 (或索引鍵) 之字串的指標,函式會傳回 S_OK,並將 pszValue 設定為指向包含該組態設定值之字串的指標。否則,函式會傳回錯誤。 如果您想要列舉目前主機上的每個組態設定,可以使用 IXtfConsoleControlClient::GetConfigSettings 函式逐一查看組態設定,並針對每個組態設定叫用您應用程式中實作的 IXtfConfigSettingsCallback::OnFoundSetting 回呼函式。您也可以使用 IXtfConsoleControlClient::GetAllSettings 方法,傳回目前開發主機上所有組態設定的 XTFCONFIGSETTING 結構陣列。 如需使用 XBOX Tools Framework (XTF) 存取組態設定的詳細資訊,請參閱組態 (xbconfig.exe) (NDA 主題)。

處理 LPBSTR 指標

如需處理此函式所傳回之 LPBSTR 指標的詳細資訊,請參閱為 BSTR 配置及釋放記憶體。

需求

標頭: xtfconsolecontrol.h 程式庫: xtfconsolecontrol.lib 支援的平台: Windows (適用於 XBOX 主機工具)

另請參閱

IXtfConsoleControlClient
XtfConsoleControl
最後修改於 2026年10月6日