Función SetupRenameErrorA (setupapi.h)
[Esta función está disponible para su uso en los sistemas operativos indicados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. 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 dispositivos.
La función RenameError genera un cuadro de diálogo que informa al usuario de un error de cambio de nombre de archivo.
Sintaxis
WINSETUPAPI UINT SetupRenameErrorA(
[in] HWND hwndParent,
[in] PCSTR DialogTitle,
[in] PCSTR SourceFile,
[in] PCSTR TargetFile,
[in] UINT Win32ErrorCode,
[in] DWORD Style
);
Parámetros
[in] hwndParent
Identificador de la ventana primaria de este cuadro de diálogo.
[in] DialogTitle
Puntero a una cadena terminada en null que especifica el título del cuadro de diálogo de error. Este parámetro puede ser NULL. Si este parámetro es NULL, se usa el título predeterminado de "Cambiar nombre de error" (localizado).
[in] SourceFile
Puntero a una cadena terminada en null que especifica la ruta de acceso completa del archivo de origen en el que se produjo un error en la operación.
[in] TargetFile
Puntero a una cadena terminada en null que especifica la ruta de acceso completa del archivo de destino en el que se produjo un error en la operación.
[in] Win32ErrorCode
Código de error del sistema encontrado durante la operación de archivo.
[in] Style
Especifica el formato de presentación y el comportamiento 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 filte 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 valores siguientes.
Para obtener información de error extendida, llame a GetLastError.
Comentarios
Nota
El encabezado setupapi.h define SetupRenameError 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 Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | setupapi.h |
| Library | Setupapi.lib |
| Archivo DLL | Setupapi.dll |