CAtlTransactionManager::RegCreateKeyEx

Artigo
02/25/2013

Cria a chave de Registro especificada e associá-la com uma transação.Se a chave já existir, a função abra-o.

inline LSTATUS CAtlTransactionManager::RegCreateKeyEx(
   HKEY hKey,
   LPCTSTR lpSubKey,
   DWORD dwReserved,
   LPTSTR lpClass,
   DWORD dwOptions,
   REGSAM samDesired,
   CONST LPSECURITY_ATTRIBUTES lpSecurityAttributes,
   PHKEY phkResult,
   LPDWORD lpdwDisposition
);

Parâmetros

hKey
Um identificador para uma chave do Registro aberta.
lpSubKey
O nome de uma subchave que essa função abra ou crie.
dwReserved
Esse parâmetro é reservado e deve ser zero.
lpClass
A classe definida pelo usuário essa chave.Este parâmetro pode ser ignorado.Este parâmetro pode ser NULO.
dwOptions
Este parâmetro pode ser um dos seguintes valores: REG_OPTION_BACKUP_RESTORE, REG_OPTION_NON_VOLATILE, ou REG_OPTION_VOLATILE.
samDesired
Uma máscara que especifica os direitos de acesso para a chave.
lpSecurityAttributes
Ponteiro a estrutura de SECURITY_ATTRIBUTES que determina se a alça retornado pode ser herdada pelos processos filho.Se lpSecurityAttributes é NULL, o identificador não pode ser herdada.
phkResult
Um ponteiro para uma variável que recebe um identificador para a chave aberta ou criada.Se a chave não é uma das chaves do Registro predefinidas, chame a função de RegCloseKey depois que você tiver terminado de usar a alça.
lpdwDisposition
Um ponteiro para uma variável que recebe uma indicação dos seguintes valores: REG_CREATED_NEW_KEY ou REG_OPENED_EXISTING_KEY.

Valor de retorno

Se a função for bem sucedida, o valor de retorno é ERROR_SUCCESS.Se a função falhar, o valor de retorno é um código de erro diferente de zero definido em Winerror.h.

Comentários

Esse wrapper chama a função de RegCreateKeyTransacted .

Requisitos

Cabeçalho: atltransactionmanager.h

Consulte também

Referência

Classe de CAtlTransactionManager

Partilhar via