Partilhar via


CRegKey::Create

Chamar esse método para criar a chave especificada, se não existir como uma subchave de hKeyParent.

LONG Create(
   HKEY hKeyParent,
   LPCTSTR lpszKeyName,
   LPTSTR lpszClass = REG_NONE,
   DWORD dwOptions = REG_OPTION_NON_VOLATILE,
   REGSAM samDesired = KEY_READ | KEY_WRITE,
   LPSECURITY_ATTRIBUTES lpSecAttr = NULL,
   LPDWORD lpdwDisposition = NULL 
) 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.

  • lpszClass
    Especifica a classe de chave a ser criada ou aberto.o valor padrão é REG_NONE.

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

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

  • lpSecAttr
    Um ponteiro a estrutura de SECURITY_ATTRIBUTES que indica se o identificador de chave pode ser herdada por um processo filho.Por padrão, este parâmetro é NULO (significar a alça não pode ser herdada).

  • lpdwDisposition
    [out] se não-nulo, recupera REG_CREATED_NEW_KEY (se a chave foi criada e não existir) ou REG_OPENED_EXISTING_KEY (se a chave existiu e foi aberta).

Valor de retorno

Se com êxito, retorna ERROR_SUCCESS e abre a chave.Se o método falhar, o valor de retorno é um código de erro diferente de zero definido em. WINERROR.H.

Comentários

Criar define o membro de m_hKey manipular essa chave.

Requisitos

Cabeçalho: atlbase.h

Consulte também

Referência

Classe de CRegKey

CRegKey::Open

CRegKey::Close