RegCreateKeyEx

9/8/2008

Essa função cria uma chave Registro usando os parâmetros especificados. Se a chave já existir no Registro, a função abrirá-lo.

Um remoto aplicativo versão interface (RAPI) dessa função existe e é chamado CeRegCreateKeyEx (RAPI).

Syntax

LONG RegCreateKeyEx( 
  HKEY hKey, 
  LPCWSTR lpSubKey, 
  DWORD Reserved, 
  LPWSTR lpClass, 
  DWORD dwOptions, 
  REGSAM samDesired, 
  LPSECURITY_ATTRIBUTES lpSecurityAttributes, 
  PHKEY phkResult, 
  LPDWORD lpdwDisposition 
); 

Parameters

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

  • HKEY_CLASSES_ROOT
  • HKEY_CURRENT_USER
  • HKEY_LOCAL_MACHINE
  • HKEY_USERS

  Windows Embedded CE não suporte o HKEY_CURRENT_CONFIG, HKEY_PERFORMANCE_DATA ou HKEY_DYN_DATA predefinidos valores identificador reservado.

  A chave que é aberto ou criado por essa função é uma subchave da chave que é identificado por esse parâmetro.

• lpSubKey
  [no] Ponteiro para uma seqüência de caracteres NULL-Terminated que especifica o nome de uma subchave que essa função abre ou cria. Esta é uma subchave da chave que é identificado por hKey. A subchave não deve começar com uma barra invertida (\). Se o parâmetro for definido como NULL, a função se comporta como RegOpenKey e abre a chave especificada pelo hKey. Em Windows Embedded CE, o comprimento máximo de uma nome da chave é 255 caracteres, excluindo o encerrando NULL caractere. Você pode aninhar only16 níveis de subchaves em Windows Embedded CE.

• Reservado
  [no] Reservado. Definido como zero.

• lpClass
  [no] Ponteiro para uma seqüência de caracteres NULL-Terminated que especifica o tipo classe ou objeto dessa chave. Este parâmetro é ignorado se a chave já existe. Em Windows Embedded CE, o comprimento máximo de seqüência de caracteres uma classe é 255 caracteres, excluindo o encerrando NULL caractere.

• dwOptions
  [no] Chave do registro Opções. A seguinte tabela mostra os valores possíveis.

  Valor	Descrição
  REG_OPTION_NON_VOLATILE	Configuração padrão. Todas as chaves Registro são criadas como não-volátil e as informações armazenadas no memória são preservadas quando o OS é reiniciado. A função RegSaveKey salva chaves que são não-volátil.
  REG_OPTION_VOLATILE	Todas as chaves Registro são criadas como volátil e de informações são armazenadas na memória e não são preservadas quando o correspondente ramificação Registro é descarregada. Para HKEY_LOCAL_MACHINE, isso ocorre quando o OS é desligado. A função RegSaveKey não salvar chaves voláteis Registro. Este sinalizador é ignorado para teclas que já existem.

• samDesired
  [no] Ignorado. Definido como zero para garantir compatibilidade com versões futuras do Windows Embedded CE.

• lpSecurityAttributes
  [no] Definir como NULL. Windows Embedded CE atribui automaticamente a chave um descritor de segurança usar como padrão.

• phkResult
  [out] Ponteiro para uma variável que recebe um identificador para a chave aberto ou criado. Quando você mais necessário o identificador retornado, chamar a função RegCloseKey para fechá-lo.

• lpdwDisposition
  [out] Ponteiro para uma variável que recebe valores de disposição. A seguinte tabela mostra os valores possíveis.

  Valor	Descrição
  REG_CREATED_NEW_KEY	A chave não existia e foi criado.
  REG_OPENED_EXISTING_KEY	A chave existia e foi aberta sem sendo alterado.

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. O recurso mensagem usado pelo FormatMessage é um opcional componente em Windows Embedded CE. Portanto, FormatMessage pode falhar.

Remarks

A chave que cria esta função não tem valores. Um aplicativo pode usar a função RegSetValueEx para definir chave valores.

Um aplicativo pode usar esta função para temporariamente bloqueio uma parte de Registro. Quando o bloqueando processo cria uma nova chave, ele recebe o valor da disposição REG_CREATED_NEW_KEY, que indica que ele é proprietário de bloqueio. Outro processo que está tentando criar a mesma chave recebe o valor da disposição REG_OPENED_EXISTING_KEY, que indica que outro processo já tem que seção do Registro bloqueado.

Requirements

Header	winreg.h
Library	coredll.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Registry Functions
RegDeleteKey
RegOpenKeyEx
RegSetValueEx

Other Resources

State and Notifications Broker