Função SHCopyKeyA (shlwapi.h)

  • Artigo

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.

Retornar valor

Tipo: LSTATUS

Retorna ERROR_SUCCESS se tiver êxito ou um dos códigos de erro diferente de 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.

Comentários

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

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

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