IItemMetadata::SetFieldByteArray
バイト配列フィールドの値を設定します。
構文
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 が返されます。
注意
このメソッドでは変更がストアに保存されません。IItemMetadata プロパティに加えたすべての変更を保存するには、IReplicaMetadata::SaveItemMetadata を呼び出す必要があります。