RegOpenKeyEx

9/8/2008

Essa função abrirá a chave especificada.

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

Syntax

LONG RegOpenKeyEx( 
  HKEY hKey, 
  LPCWSTR lpSubKey, 
  DWORD ulOptions, 
  REGSAM samDesired, 
  PHKEY phkResult 
); 

Parameters

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

  • HKEY_LOCAL_MACHINE
  • HKEY_CLASSES_ROOT
  • HKEY_CURRENT_USER
  • HKEY_USERS

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

• lpSubKey
  [no] Ponteiro para uma seqüência de caracteres NULL-Terminated que contém o nome da subchave para aberto. Se este parâmetro for definido como NULL ou um ponteiro para uma seqüência vazia, a função abre um novo identificador para a chave identificado por hKey. Neste maiúsculas e minúsculas, a função não fechar as alças anteriormente abertas.

• ulOptions
  [no] Reservado. Definido como zero.

• samDesired
  [no] Não suportado. Definido como zero.

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

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 a função FormatMessage com o conjunto sinalizador FORMAT_MESSAGE_FROM_SYSTEM. O recurso mensagem é opcional, caso FormatMessage pode falhar.

Remarks

Ao contrário a função RegCreateKeyEx, essa função não irá criar a chave especificada se a chave não existir no Registro.

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
RegCreateKeyEx
RegDeleteKey

Other Resources

State and Notifications Broker