IItemMetadata::TryGetFieldGuid
取得 GUID 欄位的值。
HRESULT TryGetFieldGuid(
LPCWSTR pcszFieldName,
GUID * rguidValue);
參數
- pcszFieldName
[in, string] 此欄位的名稱。
- rguidValue
[out] 傳回指定欄位的值。
傳回值
S_OK
如果這項值尚未設定,則為 S_FALSE。
E_POINTER
E_INVALIDARG
如果此欄位不存在,則為 SYNC_E_METADATA_FIELD_INVALID_NAME。
如果此欄位不是 GUID,則為 SYNC_E_METADATA_FIELD_INVALID_TYPE。
備註
自訂欄位必須在第一次初始化複寫中繼資料時使用 CUSTOM_FIELD_DEFINITION 結構定義。
如果呼叫了 IItemMetadata::SetFieldGuid 來設定欄位值,但是對 IReplicaMetadata::SaveItemMetadata 的呼叫尚未儲存變更,則 TryGetFieldGuid 會傳回 IItemMetadata 物件中包含的值,而不是中繼資料存放區中儲存的值。