Función SetupBackupErrorA (setupapi.h)

Artículo
11/20/2024

[Esta función está disponible para su uso en los sistemas operativos indicados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores. SetupAPI ya no debe usarse para instalar aplicaciones. En su lugar, use Windows Installer para desarrollar instaladores de aplicaciones. SetupAPI sigue usándose para instalar controladores de dispositivo.]

La función SetupBackupError genera un cuadro de diálogo que informa al usuario de un error de copia de seguridad.

Sintaxis

WINSETUPAPI UINT SetupBackupErrorA(
  [in]  HWND  hwndParent,
  [in]  PCSTR DialogTitle,
  [in]  PCSTR SourceFile,
  [in]  PCSTR TargetFile,
  [out] UINT  Win32ErrorCode,
  [in]  DWORD Style
);

Parámetros

[in] hwndParent

Identificador de la ventana primaria de este cuadro de diálogo.

[in] DialogTitle

Puntero opcional a un cadena terminadanull que especifica el título del cuadro de diálogo de error. Si este parámetro es NULL, se usa el título predeterminado de "Error de copia de seguridad" (localizado).

[in] SourceFile

Puntero a un cadena terminadanull que especifica la ruta de acceso completa del archivo de origen de la que se realiza una copia de seguridad.

[in] TargetFile

Puntero opcional a un cadena terminadanull que especifica la ruta de acceso completa del nombre de copia de seguridad del archivo. Este parámetro puede ser null.

[out] Win32ErrorCode

Si se produce un error, este miembro es el código de error del sistema . Si no se ha producido ningún error, se NO_ERROR.

[in] Style

Marcas que controlan el formato y el comportamiento de visualización del cuadro de diálogo. Este parámetro puede ser una de las marcas siguientes.

IDF_NOBEEP

Evite que el cuadro de diálogo se despide para llamar la atención del usuario cuando aparezca por primera vez.

IDF_NOFOREGROUND

Impedir que el cuadro de diálogo se convierta en la ventana de primer plano.

Valor devuelto

Esta función devuelve uno de los siguientes valores.

Para obtener información de error extendida, llame a GetLastError.

Observaciones

Nota

El encabezado setupapi.h define SetupBackupError 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 XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	setupapi.h
biblioteca de	Setupapi.lib
DLL de	Setupapi.dll