Compartilhar via


Função SHCopyKeyA (shlwapi.h)

Copia recursivamente as subchaves e os valores da subchave de origem para a chave de destino. SHCopyKey não copia os atributos de segurança das chaves.

Sintaxe

LSTATUS SHCopyKeyA(
  [in]           HKEY   hkeySrc,
  [in, optional] LPCSTR pszSrcSubKey,
  [in]           HKEY   hkeyDest,
                 DWORD  fReserved
);

Parâmetros

[in] hkeySrc

Tipo: HKEY

Um identificador para a chave de origem (por exemplo, HKEY_CURRENT_USER).

[in, optional] pszSrcSubKey

Tipo: LPCTSTR

A subchave cujas subchaves e valores devem ser copiados.

[in] hkeyDest

Tipo: HKEY

A chave de destino.

fReserved

Tipo: DWORD

Reservado. Deve ser 0.

Valor de retorno

Tipo: LSTATUS

Retorna ERROR_SUCCESS se bem-sucedido ou um dos códigos de erro não zero definidos em Winerror.h caso contrário. Use FormatMessage com o sinalizador FORMAT_MESSAGE_FROM_SYSTEM para recuperar uma descrição genérica do erro.

Observações

Importante Essa função não duplica os atributos de segurança das chaves e dos valores copiados. Em vez disso, todos os atributos de segurança na chave de destino são os atributos padrão.
 

Nota

O cabeçalho shlwapi.h define SHCopyKey como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho shlwapi.h
biblioteca Shlwapi.lib
de DLL Shlwapi.dll (versão 5.0 ou posterior)