設定位元組陣列欄位的值。
HRESULT SetFieldByteArray(
LPCWSTR pcszFieldName,
BYTE * pbValue,
ULONG cbValue);
參數
- pcszFieldName
[in, string] 此欄位的名稱。
- pbValue
[in, unique, size_is(cbValue)] 此欄位的值。
- cbValue
[in] pbValue 中的位元組數目。
傳回值
S_OK。
E_POINTER。
E_INVALIDARG。
如果此欄位不存在，則為 SYNC_E_METADATA_FIELD_INVALID_NAME。
如果此欄位不是位元組陣列類型，則為 SYNC_E_METADATA_FIELD_INVALID_TYPE。
備註
對 pbValue 指定 NULL 並且對 cbValue 指定 0，就可將此欄位值重設為空值。如果 pbValue 設定為 NULL 但 cbValue 不是 0，或者 cbValue 為 0 而 pbValue 不是設定為 NULL，就會傳回 E_INVALIDARG。
注意
這個方法不會將變更儲存到存放區，必須呼叫 IReplicaMetadata::SaveItemMetadata 來儲存對 IItemMetadata 屬性做的所有變更。