CeWriteRecordProps (CEDB)

9/8/2008

Essa função grava um conjunto de propriedades para um registro individual, criando o registro se necessário.

Essa função não trabalho com bancos de dados Edb. Para obter mais informações, consulte EDB Functions.

Uma versão RAPI dessa função existe chamado CeWriteRecordProps (RAPI).

Syntax

CEOID CeWriteRecordProps(
  HANDLE hDbase, 
  CEOID oidRecord, 
  WORD cPropID, 
  CEPROPVAL* rgPropVal
); 

Parameters

• hDbase
  [no] Identificador para um aberto banco de dados. O banco de dados devem foram abertos por um chamar anterior para a função CeOpenDatabase (CEDB).

• oidRecord
  [no] Identificador de objeto do registro ao qual as propriedades especificadas são a serem gravados. Se este parâmetro for definido para zero, um novo registro é criado e preenchido com as propriedades especificadas.

• cPropID
  [no] Número de propriedades na matriz especificada pelo rgPropVal parâmetro. O cPropID parâmetro não deve ser definido para zero.

• rgPropVal
  [no] Ponteiro para uma matriz de CEPROPVAL (CEDB) estruturas que especificar os valores propriedade a ser gravado o registro especificado.

Return Value

Identificador de objeto do registro ao qual as propriedades foram escritas indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError. A seguinte tabela mostra possíveis valores de retorno.

Valor	Descrição
ERROR_DISK_FULL	Indica que theres não foi suficiente espaço em armazenar o objeto para gravar as propriedades.
ERROR_INVALID_PARAMETER	Indica que um parâmetro estava inválido.

Remarks

Essa função grava todas as propriedades solicitadas para o registro especificado. Essa função deixa o ponteiro de busca sobre o registro que está gravado. No entanto, a posição desse registro na ordem de classificar pode alteração se suas propriedades classificar forem modificadas. Portanto, usando essa função em conjunto com a função CeSeekDatabaseEx (CEDB) pode resultar em comportamento inesperado buscar.

Para excluir uma propriedade, defina o sinalizador CEDB_PROPDELETE no apropriado valor da propriedade. Isso permite que múltiplo exclui e altera em um único chamar, que é muito mais eficiente que chama múltiplo.

Nenhuma memória é liberada pelo chamador. Ponteiros in a CEPROPVAL Estruturas podem estar em qualquer lugar na espaço de endereço do chamador. Eles podem ser empacotados, as in a matriz retornado pela função a CeReadRecordProps (CEDB), ou eles podem ser alocados de forma independente.

Windows CE 2.10 e posterior, em um volume montado banco de dados, todos gravar operações são armazenados em cache. O subsistema banco de dados periodicamente solicita um armazenar em cache liberado após uma série de operações. Se for baixa memória, o armazenar em cache é liberado para armazenamento permanente. Ao contrário um sistema de arquivos que pode escolher para liberado somente parte de armazenar em cache, em um banco de dados, todos os blocos são liberados.

Se essa função é chamado por um segmento cliente sincronização replicação, os sinalizadores sincronização determinam seu comportamento. Se o cliente tiver definido o sinalizador REPL_SYNC_ALLOWOVERWRITE, o chamar continua normalmente. Se o sinalizador REPL_SYNC_ALLOWOVERWRITE não estiver definida, a chamar pode falhar com ERROR_ACCESS_DENIED, para o cliente sincronização substituam as alterações ela não foi ainda ler bloco. Para obter mais informações, consulte ReplOpenSync e ReplChangeSyncSettings.

Requirements

Header	windbase.h
Library	coredll.lib
Windows Embedded CE	Windows CE 1.01 and later

See Also

Reference

CEDB Functions
CeOpenDatabaseEx2 (CEDB)
CeReadRecordPropsEx (CEDB)
CEPROPVAL (CEDB)
ReplOpenSync
ReplChangeSyncSettings