Compartilhar 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