Función SHCopyKeyA (shlwapi.h)

Copia de forma recursiva las subclaves y los valores de la subclave de origen en la clave de destino. SHCopyKey no copia los atributos de seguridad de las claves.

Sintaxis

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

Parámetros

[in] hkeySrc

Tipo: HKEY de

Identificador de la clave de origen (por ejemplo, HKEY_CURRENT_USER).

[in, optional] pszSrcSubKey

Tipo: LPCTSTR de

Subclave cuyas subclaves y valores se van a copiar.

[in] hkeyDest

Tipo: HKEY de

Clave de destino.

fReserved

Tipo: DWORD de

Reservado. Debe ser 0.

Valor devuelto

Tipo: LSTATUS de

Devuelve ERROR_SUCCESS si se ejecuta correctamente o uno de los códigos de error distintos de cero definidos en Winerror.h de lo contrario. Use formatMessage con la marca FORMAT_MESSAGE_FROM_SYSTEM para recuperar una descripción genérica del error.

Observaciones

Importante Esta función no duplica los atributos de seguridad de las claves y los valores que copia. En su lugar, todos los atributos de seguridad de la clave de destino son los atributos predeterminados.

 

Nota

El encabezado shlwapi.h define SHCopyKey como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	shlwapi.h
biblioteca de	Shlwapi.lib
DLL de	Shlwapi.dll (versión 5.0 o posterior)