從背景工作進程或應用程式集區設定擷取字串值。
語法
virtual HRESULT GetStringProperty(
IN WPF_SETTINGS_STRING_ENUM SettingId,
__out_ecount_opt(*pcchSetting) PWSTR pszSetting,
IN OUT DWORD* pcchSetting
) = 0;
參數
SettingId
[IN] WPF_SETTINGS_STRING_ENUM 值，指定要傳回的字串值。
pszSetting
[OUT]字串緩衝區的指標，接收 所 SettingId 指定的值。
pcchSetting
[IN][OUT]緩衝區的 DWORD 指標，接收 中 pszSetting 傳回之字串的大小。
傳回值
HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
| 值 | 描述 |
|---|---|
| S_OK | 表示作業成功。 |
| ERROR_INSUFFICIENT_BUFFER | 表示沒有足夠的緩衝區空間可執行作業。 |
| ERROR_INVALID_PARAMETER | 表示指定的參數無效。 (參數超出範圍，或不是 string.) |
備註
因為參數是選擇性的 pszSetting ，所以可能是 Null。 如果字串值的大小超過 參數所 pcchSetting 指定的大小，則方法會傳回ERROR_INSUFFICIENT_BUFFER。
規格需求
| 類型 | 描述 |
|---|---|
| Client | - Windows Vista 上的 IIS 7.0 - Windows 7 上的 IIS 7.5 - Windows 8 上的 IIS 8.0 - Windows 10上的 IIS 10.0 |
| 伺服器 | - Windows Server 2008 上的 IIS 7.0 - Windows Server 2008 R2 上的 IIS 7.5 - Windows Server 2012 上的 IIS 8.0 - Windows Server 2012 R2 上的 IIS 8.5 - Windows Server 2016上的 IIS 10.0 |
| 產品 | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 - IIS Express 7.5、IIS Express 8.0、IIS Express 10.0 |
| 標頭 | Wpframework.h |
另請參閱
IWpfSettings 介面
IWpfSettings：：GetBoolProperty 方法
IWpfSettings：：GetDwordProperty 方法
IWpfSettings：：GetHandleProperty 方法
IWpfSettings：：GetUlonglongProperty 方法
WPF_SETTINGS_STRING_ENUM列舉