CeRegSetValueEx (RAPI)

9/8/2008

Essa função armazena dados no campo de valor de um aberto chave Registro em um remoto dispositivo baseado em Windows Embedded CE. Ele também pode definir informações adicionais valor e tipo para a chave especificada.

Syntax

LONG CeRegSetValueEx (
  HKEY hKey,
  LPCWSTR lpValueName,
  DWORD Reserved,
  DWORD dwType,
  LPBYTE lpData,
  DWORD cbData
);

Parameters

• hKey
  [no] Identificador para um atualmente aberto identificador reservado valores predefinidos chave ou de qualquer o seguinte:

  HKEY_CLASSES_ROOT

  HKEY_CURRENT_USER

  HKEY_LOCAL_MACHINE

  HKEY_USERS

• lpValueName
  [no] Ponteiro para uma seqüência de caracteres que contém o nome do valor para definir. Se um valor com este nome já não estiver presente na chave, a função adiciona-lo para a chave. Se este parâmetro é NULL ou um seqüência vazia, a função define o tipo e dados para sem nome a chave valor. Chaves do Registro não é necessário valores usar como padrão, mas elas podem ter um sem nome valor, que pode ser de qualquer tipo. O comprimento máximo de um nome valor é 255, não incluindo o encerrando NULL caractere.

• Reservado
  [no] Reservado; Deve ser zero.

• dwType
  [no] Especifica o tipo de informações sejam armazenados como dados de valor. Este parâmetro pode ser uma dos seguinte valores.

  Valor	Descrição
  REG_BINARY	Dados binários em qualquer forma.
  REG_DWORD	Um 32-bit número.
  REG_DWORD_LITTLE_ENDIAN	Um 32-bit número no formato little-endian. Isso é equivalente para REG_DWORD. No formato little-endian, um valor de múltiplos bytes é armazenada na memória a partir de byte mais baixo (o " fim pouco") para o byte mais alto. Exemplo, o valor 0x12345678 é armazenado como (0x56 0x78 0x34 0 x 12) no formato little-endian.
  REG_DWORD_BIG_ENDIAN	Um 32-bit número no formato big-endian. No formato big-endian, um valor de múltiplos bytes é armazenada na memória a partir de byte mais alto (o " big end") para o byte mais baixo. Exemplo, o valor 0x12345678 é armazenado como (0 x 12 0x34 0x78 0x56) no formato big-endian.
  REG_EXPAND_SZ	Um seqüência de caracteres NULL-Terminated que contém referências unexpanded a variáveis ambiente (por exemplo, "% path %").
  REG_LINK	Um link simbólico Unicode. Usada internamente; aplicativos não devem usar este tipo.
  REG_MULTI_SZ	Uma matriz de seqüências de caracteres NULL-Terminated, finalizado pelo NULL dois caracteres.
  REG_NONE	Nenhuma tipo de valor definido.
  REG_RESOURCE_LIST	Um dispositivo-driver recurso lista.
  REG_SZ	Um seqüência de caracteres NULL-Terminated. Não use o tipo REG_SZ para armazenar rígido-codificado caminhos para o sistema raiz Diretório ou para a unidade que contém os arquivos sistema. Em vez disso, use o tipo REG_EXPAND_SZ com variáveis ambiente, como "% SystemRoot %". Isso garante que o caminho será atualizado mesmo se o usuário remapeia unidade de sistema para um letra da unidade diferentes.

• lpData
  [no] Ponteiro para uma reserva contendo os dados sejam armazenados com o nome valor especificado.

• cbData
  [no] Especifica o tamanho, em bytes, das informações apontado pelo lpData parâmetro. Se a dados for do tipo REG_SZ, REG_EXPAND_SZ ou REG_MULTI_SZ, cbData Deve incluir o tamanho da caractere nulo de terminação. O tamanho máximo de dados permitidos em Windows Embedded CE é 4 KB.

Return Value

ERROR_SUCCESS indica sucesso. Um diferente de zero código de erro definidos no Winerror.h indica falha. Para get um genérico descrição do erro, chamar FormatMessage Com o conjunto sinalizador FORMAT_MESSAGE_FROM_SYSTEM.

Remarks

Comprimentos valor são limitados pelo disponível memória. Valores longos (maiores que 2.048 bytes) devem ser armazenados como arquivos com os nomes dos arquivos armazenados no Registro. Isso ajuda na eficiência da execução do Registro. Elementos do aplicativo como ícones, bitmaps e arquivos executáveis devem ser armazenados como arquivos e não ser colocados no Registro.

A chave identificado pelo hKey parâmetro deve ter sido aberto com acessar KEY_SET_VALUE. Para aberto a chave, use o CeRegCreateKeyEx Ou CeRegOpenKeyEx função.

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
CeRegCreateKeyEx (RAPI)
CeRegOpenKeyEx (RAPI)
CeRegQueryValueEx (RAPI)