CeWriteRecordProps (RAPI)

9/8/2008

Essa função grava um conjunto de propriedades para um registro único banco de dados em um remoto dispositivo baseado em Windows Embedded CE.

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 o CeOpenDatabase função.

• oidRecord
  [no] Identificador de objeto do registro ao qual as propriedades especificadas são a serem gravados. Se este parâmetro for 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 zero.

• rgPropVal
  [no] Ponteiro para uma matriz de CEPROPVAL 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 CeGetLastError e CeRapiGetError. CeGetLastError pode retornar uma dos seguinte valores.

Valor	Descrição
ERROR_DISK_FULL	Não havia espaço suficiente em armazenar o objeto para gravar as propriedades.
ERROR_INVALID_PARAMETER	Foi um parâmetro inválido.

Remarks

O CeWriteRecordProps método não mover o ponteiro da busca.

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 receptor. Ponteiros in a CEPROPVAL Estruturas podem estar em qualquer lugar no espaço de endereço do chamador — eles podem ser empacotados em como a matriz retornado por CeReadRecordProps, ou eles podem ser alocados de forma independente.

Para versões Windows Embedded CE 2.10 e posteriores, 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.

Observação

Versões anteriores de Windows Embedded CE atribuído objeto identificadores a objetos em outros sistemas arquivo, such as o sistema de arquivos tabela de alocação de arquivos (FAT).Esses identificadores objeto foram garantia ser exclusivo em um volume, mas não entre múltiplo volumes.Eficaz com versão 3.0, apenas objetos em armazenar o objeto tiver válido, exclusivo objeto identificadores e armazenar o objeto é o único volume que pode retornar um objeto identificador.

Requirements

Header	rapi.h
Library	rapi.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

RAPI Functions