IItemMetadata::SetFieldString
設定字串欄位的值。
HRESULT SetFieldString(
LPCWSTR pcszFieldName,
LPCWSTR pcszValue);
參數
- pcszFieldName
[in, string] 此欄位的名稱。
- pcszValue
[in, unique] 此欄位的值。
傳回值
S_OK
E_POINTER
E_INVALIDARG
如果此欄位不存在，則為 SYNC_E_METADATA_FIELD_INVALID_NAME。
如果此欄位在自訂欄位結構描述中不是字串類型，則為 SYNC_E_METADATA_FIELD_INVALID_TYPE。
備註
對 pcszValue 指定 NULL 可將此欄位重設為空值。
自訂欄位必須在第一次初始化複寫中繼資料時使用 CUSTOM_FIELD_DEFINITION 結構定義。
注意
這個方法不會將變更儲存到存放區，必須呼叫 IReplicaMetadata::SaveItemMetadata 來儲存對 IItemMetadata 屬性做的所有變更。