SHPropStgWriteMultiple 函式 (shlobj_core.h)

[此函式可透過 Windows XP Service Pack 2 (SP2) 和 Windows Server 2003 取得。 後續版本的 Windows 中可能會變更或無法使用。

包裝 IPropertyStorage：：WriteMultiple 函式，以確保已針對已被取代的屬性集正確處理 ANSI 和 Unicode 轉譯。

語法

SHSTDAPI SHPropStgWriteMultiple(
  [in]                IPropertyStorage  *pps,
  [in, out, optional] UINT              *puCodePage,
                      ULONG             cpspec,
  [in]                PROPSPEC const [] rgpspec,
  [in, out]           PROPVARIANT []    rgvar,
                      PROPID            propidNameFirst
);

參數

[in] pps

類型： IPropertyStorage*

識別屬性存放區的 IPropertyStorage 介面指標。

[in, out, optional] puCodePage

類型： UINT*

ANSI 字串屬性之字碼頁值的指標。

cpspec

類型： ULONG

正在設定的屬性計數。

[in] rgpspec

類型： PROPSPEC const[]

PROPSPEC 結構的陣列，其中包含要設定的屬性資訊。

[in, out] rgvar

類型： PROPVARIANT[]

要設定屬性值的 PROPVARIANT 型別陣列。

propidNameFirst

類型： PROPID

必須配置屬性識別碼時的最小值。 此值應大於或等於 PID_FIRST_USABLE。

傳回值

類型： HRESULT

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

需求

最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	shlobj_core.h
程式庫	Shell32.lib
Dll	Shell32.dll (6.0 版或更新版本)