Partilhar via


CRegKey::Open

Chamar esse método para abrir a chave especificada e m_hKey ajustado para o identificador de essa chave.

LONG Open( 
   HKEY hKeyParent, 
   LPCTSTR lpszKeyName, 
   REGSAM samDesired = KEY_READ | KEY_WRITE 
) throw( );

Parâmetros

  • hKeyParent
    O identificador de uma chave aberta.

  • lpszKeyName
    Especifica o nome de uma chave a ser criada ou aberto. Este nome deve ser uma subchave de hKeyParent.

  • samDesired
    Acesso de segurança para a chave. o valor padrão é KEY_ALL_ACCESS. Para obter uma lista de valores e descrições de possíveis, consulte RegCreateKeyEx em Windows SDK.

Valor de retorno

Se com êxito, retorna ERROR_SUCCESS; caso contrário, um valor diferente de zero de erro definido em. WINERROR.H.

Comentários

Se o parâmetro de lpszKeyName é NULL ou aponta para uma cadeia de caracteres vazia, Abrir abre um novo identificador de chave identificada por hKeyParent, mas não fecha nenhuma alça anteriormente aberta.

A o contrário de CRegKey::Create, Abrir não criará a chave especificada se ele não existir.

Requisitos

Cabeçalho: atlbase.h

Consulte também

Referência

Classe de CRegKey

CRegKey::Close