IItemMetadata::SetFieldByteArray
Define o valor de um campo de matriz de bytes.
HRESULT SetFieldByteArray(
LPCWSTR pcszFieldName,
BYTE * pbValue,
ULONG cbValue);
Parâmetros
- pcszFieldName
[in, string] O nome do campo.
- pbValue
[in, unique, size_is(cbValue)] O valor do campo.
- cbValue
[in] O número de bytes em pbValue.
Valor de retorno
S_OK.
E_POINTER.
E_INVALIDARG.
SYNC_E_METADATA_FIELD_INVALID_NAME se o campo não existir.
SYNC_E_METADATA_FIELD_INVALID_TYPE se o campo não for do tipo de matriz de byte.
Comentários
O valor de campo pode ser redefinido como um valor vazio especificando NULL para pbValue e 0 para cbValue. Se pbValue for definido como NULL mas cbValue não for 0, ou se cbValue for 0 e pbValue não for NULL, E_INVALIDARG será retornado.
Dica
Este método não salva a alteração no repositório. É necessário chamar IReplicaMetadata::SaveItemMetadata para salvar todas as alterações feitas nas propriedades de IItemMetadata.