IItemMetadata::TryGetFieldUInt8
Obtém o valor de um campo de um inteiro não assinado de 8 bits.
HRESULT TryGetFieldUInt8(
LPCWSTR pcszFieldName,
BYTE * pbValue);
Parâmetros
- pcszFieldName
[in, string] O nome do campo.
- pbValue
[out] Retorna o valor do campo especificado.
Valor de retorno
S_OK
S_FALSE se o valor não estiver definido.
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 é do tipo inteiro não assinado de 8 bits.
Comentários
Os campos personalizados devem ser definidos usando uma estrutura CUSTOM_FIELD_DEFINITION ao inicializar pela primeira vez os metadados da réplica.
Se IItemMetadata::SetFieldUInt8 for chamado para definir o valor do campo, mas a alteração não estiver salva por uma chamada a IReplicaMetadata::SaveItemMetadata, TryGetFieldUInt8 retorna o valor contido no objeto IItemMetadata e não o valor do repositório de metadados.