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