Função SHCopyKeyW (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 SHCopyKeyW(
  [in]           HKEY    hkeySrc,
  [in, optional] LPCWSTR 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 diferentes 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

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)