mensaje de SPFILENOTIFY_NEEDNEWCABINET
SetupIterateCabinet envía la notificación SPFILENOTIFY_NEEDNEWCABINET para indicar que el archivo actual continúa en otro gabinete. La rutina de devolución de llamada puede llamar a SetupPromptForDisk o crear su propio cuadro de diálogo para pedir al usuario que inserte el siguiente disco.
SPFILENOTIFY_NEEDNEWCABINET
Param1 = (UINT) CabinetInfo;
Param2 = (UINT) NewPath;
Parámetros
-
Param1
-
Puntero a una estructura de CABINET_INFO que contiene información sobre el gabinete y el archivo que se va a extraer.
-
Param2
-
Si la devolución de llamada devuelve NO_ERROR, este parámetro es un puntero a una cadena terminada en null. Si la cadena no está vacía, especifica una nueva ruta de acceso al gabinete.
Valor devuelto
La rutina debe devolver uno de los valores siguientes.
| Código devuelto | Descripción |
|---|---|
|
No se encontró ningún error, continúe procesando el gabinete. |
|
Error del tipo especificado. La función SetupIterateCabinet devolverá FALSE y una llamada a GetLastError devolverá el código de error especificado. |
Nota
No hay ninguna rutina de devolución de llamada predeterminada del gabinete; por lo tanto, debe proporcionar una rutina de devolución de llamada para controlar las notificaciones enviadas por SetupIterateCabinet.
Comentarios
Si la rutina de devolución de llamada devuelve NO_ERROR, SetupIterateCabinet comprueba el búfer al que apunta Param2. Si el búfer no está vacío, contiene una nueva ruta de acceso de origen. Si el búfer está vacío, se supone que la ruta de acceso de origen no cambia.
La función de devolución de llamada debe asegurarse de que el gabinete sea accesible antes de que vuelva, llamando a la función SetupPromptForDisk , si es necesario insertar nuevos medios.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2003 [solo aplicaciones de escritorio] |
| Encabezado |
|