共用方式為


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

另請參閱

IPropertySetStorage::Create

IPropertyStorage

IPropertyStorage::ReadMultiple

管理屬性集

PROPVARIANT

範例

StgCreatePropSetStg 範例

WriteRead 範例