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