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
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) |