Función SHCopyKeyA (shlwapi.h)

  • Artículo

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

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

[in, optional] pszSrcSubKey

Tipo: LPCTSTR

Subclave cuyas subclaves y valores se van a copiar.

[in] hkeyDest

Tipo: HKEY

Clave de destino.

fReserved

Tipo: DWORD

Reservado. Debe ser 0.

Valor devuelto

Tipo: LSTATUS

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.

Comentarios

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlwapi.h
Library Shlwapi.lib
Archivo DLL Shlwapi.dll (versión 5.0 o posterior)