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