Compartilhar via


IItemMetadata::SetFieldString

Define o valor de um campo de cadeia de caracteres.

HRESULT SetFieldString(
  LPCWSTR pcszFieldName,
  LPCWSTR pcszValue);

Parâmetros

  • pcszFieldName
    [in, string] O nome do campo.
  • pcszValue
    [in, unique] O valor do campo.

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 quando o campo não é do tipo de cadeia de caracteres no esquema do campo personalizado.

Comentários

O valor de campo pode ser redefinido como um valor vazio especificando NULL para pcszValue.

Os campos personalizados devem ser definidos usando a estrutura CUSTOM_FIELD_DEFINITION ao inicializar pela primeira vez os metadados da réplica.

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.

Consulte também

Referência

Interface IItemMetadata