針對從序列化中繼資料中讀取的每個項目發生一次。
HRESULT OnItemMetadataDeserialized(
IItemMetadata * pItemMetadata,
LPCWSTR * pcszExtraFieldNames,
IFieldValue ** ppExtraFieldValues,
BYTE cExtraFields);
參數
- pItemMetadata
[in] 採用升級格式之項目的中繼資料。
- pcszExtraFieldNames
[in, size_is(cExtraFields)] 存在序列化中繼資料內,但是並未針對新中繼資料結構描述指定在自訂欄位清單中的額外欄位名稱。如果 cExtraFields 為 0,設定為 NULL。
- ppExtraFieldValues
[in, size_is(cExtraFields)] 存在序列化中繼資料內,但是並未針對新中繼資料結構描述指定在自訂欄位清單中的額外欄位值。如果 cExtraFields 為 0,設定為 NULL。
- cExtraFields
[in] 存在序列化中繼資料內,但是並未針對新中繼資料結構描述指定在自訂欄位清單中的額外欄位數目。
傳回值
S_OK
提供者決定的錯誤碼
備註
當提供者收到這個方法時,它可以檢查 pcszExtraFieldNames 和 ppExtraFieldValues 中的額外欄位,並且進行任何必要的變更來修正項目中繼資料,例如將舊結構描述中額外欄位的資料合併至 pItemMetadata 中所包含之升級結構描述的現有欄位中。