CeRegCreateKeyEx (RAPI)

9/8/2008

Essa função cria uma chave Registro em um remoto dispositivo baseado em Windows Embedded CE. Se a chave já existe no Registro, esse método abrirá.

Syntax

LONG CeRegCreateKeyEx( 
  HKEY hKey, 
  LPCWSTR lpszSubKey, 
  DWORD Reserved, 
  LPWSTR lpszClass, 
  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 aberto ou criado pela CeRegCreateKeyEx função é uma subchave da chave identificado pelo hKey parâmetro.

• lpszSubKey
  [no] Ponteiro para uma seqüência de caracteres NULL-Terminated especificando o nome de uma subchave que essa função abre ou cria. A subchave especificada deve ser uma subchave da chave identificado pelo hKey parâmetro. Essa subchave não deve começar com o caractere barra invertida (\). Se o parâmetro é NULL, em seguida, RegCreateKeyEx se comporta como CeRegOpenKey, onde ele abre a chave especificada pelo hKey. Em Windows Embedded CE, o comprimento máximo de uma nome da chave é 255 caracteres, não incluindo o encerrando NULL caractere. Você pode aninhar 16 também apenas níveis de subchaves em Windows Embedded CE.

• Reservado
  [no] Reservado; Defina como 0.

• lpszClass
  [no] Ponteiro para uma seqüência de caracteres NULL-Terminated que especifica a classe (tipo 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, não incluindo o encerrando NULL caractere.

• dwOptions
  [no] Ignorada; Definido como 0 para garantir compatibilidade com versões futuras do Windows Embedded CE.

• samDesired
  [no] Ignorada; Definido como 0 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 o CeRegCloseKey função para fechá-lo.

• lpdwDisposition
  [out] Ponteiro para uma variável que recebe uma do seguinte valores da disposição.

  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 simplesmente 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.

Remarks

A chave que o CeRegCreateKeyEx função cria não tem valores. Um aplicativo pode usar o CeRegSetValueEx função para definir chave valores.

CeRegCreateKeyEx Pode criar chaves sob os registros HKEY_USERS e HKEY_LOCAL_MACHINE.

Um aplicativo pode usar CeRegCreateKeyEx Para temporariamente bloqueio uma parte do Registro. Quando o bloqueando processo cria uma nova chave, ele recebe o valor da disposição REG_CREATED_NEW_KEY, indicando que ele "possui" o bloqueio. Outro processo está tentando criar a mesma chave recebe o valor da disposição REG_OPENED_EXISTING_KEY, indicando que outro processo já possui o bloqueio.

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
CeRegDeleteKey (RAPI)