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.