IPropertyStorage：：WriteMultiple 方法 (propidlbase.h)
WriteMultiple 方法會將指定的屬性群組寫入至目前的屬性集。 如果具有指定名稱或屬性標識符的屬性已經存在，即使屬性值的舊型別和新型別不同，也會加以取代。 如果指定名稱或屬性標識碼的屬性不存在，則會建立它。
語法
HRESULT WriteMultiple(
[in] ULONG cpspec,
[in] const PROPSPEC [] rgpspec,
[in] const PROPVARIANT [] rgpropvar,
[in] PROPID propidNameFirst
);
參數
[in] cpspec
設定的屬性數目。 此參數的值可以設定為零;不過，這會使方法的用途失效，因為接著不會寫入任何屬性。
[in] rgpspec
屬性標識碼的陣列， (PROPSPEC) 屬性的設定。 這些不需要以任何特定順序排列，而且可能包含重複項目，不過最後指定的屬性標識碼是生效的屬性標識碼。 允許混合屬性識別碼和字串名稱。
[in] rgpropvar
包含要寫入之屬性值的 PROPVARIANT 結構大小 cpspec) 陣列 (。 陣列必須是 cpspec 所指定的大小。
[in] propidNameFirst
如果 rgpspec 參數指定了目前不存在任何屬性識別碼的字串命名屬性，則方法必須指派的屬性標識碼的最小值。 如果指定的所有字串命名屬性都已存在於此集合中，因此已經有屬性識別碼，則會忽略此值。 如果未忽略，這個值必須大於或等於兩個，且小於0x80000000。 屬性標識碼 0 和 1 和大於0x80000000會保留供特殊使用。
傳回值
除了下列專案外，這個方法還支援標準傳回值E_UNEXPECTED：
此函式也可以傳回任何檔案系統錯誤或包裝在 HRESULT 資料類型中的 Win32 錯誤。 如需詳細資訊，請參閱 錯誤處理策略。
備註
如果指定的屬性已經存在，則會將其值取代為 rgpspec 中指定的值，即使屬性值的舊型別和新型別不同也一樣。 如果指定的屬性不存在，則會建立該屬性。 在呼叫 IPropertyStorage：：Commit 之前，這些變更不會保存到基礎記憶體。
屬性名稱會儲存在屬性集的特殊字典區段中，這會將這類名稱對應至屬性標識元。 所有屬性都有標識碼，但名稱是選擇性的。 字串名稱是在 PROPSPEC 結構的 ulKind 成員中指定PRSPEC_LPWSTR來提供。 如果為屬性提供字串名稱，而且名稱不存在於字典中，則方法會配置屬性標識碼，並將屬性標識碼和名稱新增至字典。 屬性標識碼的配置方式與屬性集中的其他標識符不衝突。 屬性標識碼的值也不會小於 propidNameFirst 參數所指定的值。 如果 rgpspec 參數指定目前沒有屬性識別碼的字串命名屬性， propidNameFirst 參數會指定 WriteMultiple 方法必須指派之屬性識別符的最小值。
建立新的屬性集時，特殊 代碼頁 (屬性標識碼 1) 和地區設定標識碼 (屬性標識碼0x80000000) 屬性會自動 寫入屬性集。 後續可以使用 IPropertyStorage：：ReadMultiple 方法來讀取這些屬性，方法是分別使用標頭定義的PID_CODEPAGE和PID_LOCALE值來指定屬性標識符。 如果屬性集不是空的 — 除了代碼頁和地區設定標識符屬性之外，還有一或多個屬性，或在其字典中有一或多個名稱，則無法藉由呼叫 IPropertyStorage：：WriteMultiple 來修改特殊代碼頁和地區設定標識符屬性。 不過，如果屬性集是空的，則可以修改其中一或兩個特殊屬性。
如果 rgspec 陣列中的項目設定為PRSPEC_PROPID值0xffffffff (PID_ILLEGAL) ，IPropertyStorage：：WriteMultiple 會忽略 rgvar 陣列中的對應值。 例如，如果使用 cspec 參數設定為 3 呼叫此方法，但 rgpspec[1].prspec 設定為 PRSPEC_PROPID， 而 rgpspec[1].propid 設定為 PID_ILLEGAL，則只會寫入兩個屬性。 會以無訊息方式忽略 rgpropvar[1] 元素。
使用 PropVariantInit 宏來初始化 PROPVARIANT 結構。
屬性集，不包括非簡單屬性的數據，大小限制為 256 KB，Windows NT 4.0 和更早版本。 針對 Windows 2000、Windows XP 和 Windows Server 2003，OLE 屬性集限制為 1 MB。 如果超過這些限制，作業會失敗，而且呼叫端會收到錯誤訊息。 記憶體流失或滿溢不可能。 如需詳細資訊，請參閱 管理屬性集。
除非PROPSETFLAG_CASE_SENSITIVE傳遞至 IPropertySetStorage：：Create，否則屬性集名稱不區分大小寫。 在 IPropertyStorage：：WriteMultiple 中指定屬性，會導致屬性集中的名稱不區分大小寫搜尋。 若要比較不區分大小寫的字串，必須知道字串的地區設定。 如需詳細資訊，請參閱 IPropertyStorage：：WritePropertyNames。
如需詳細資訊，請參閱 屬性記憶體考慮。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | propidlbase.h (包括 Objbase.h、Propidlbase.h) |
| 程式庫 | Uuid.lib |
| Dll | Ole32.dll |