SPFILENOTIFY_NEEDNEWCABINET mensagem
A notificação SPFILENOTIFY_NEEDNEWCABINET é enviada por SetupIterateCabinet para indicar que o arquivo atual continua em outro gabinete. Sua rotina de retorno de chamada pode chamar SetupPromptForDisk ou criar sua própria caixa de diálogo para solicitar que o usuário insira o próximo disco.
SPFILENOTIFY_NEEDNEWCABINET
Param1 = (UINT) CabinetInfo;
Param2 = (UINT) NewPath;
Parâmetros
-
Param1
-
Ponteiro para uma estrutura CABINET_INFO que contém informações sobre o gabinete e o arquivo a ser extraído.
-
Param2
-
Se o retorno de chamada retornar NO_ERROR, esse parâmetro será um ponteiro para uma cadeia de caracteres terminada em nulo. Se a cadeia de caracteres não estiver vazia, ela especificará um novo caminho para o gabinete.
Valor retornado
Sua rotina deve retornar um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
|
Nenhum erro foi encontrado, continue processando o gabinete. |
|
Ocorreu um erro do tipo especificado. A função SetupIterateCabinet retornará FALSE e o código de erro especificado será retornado por uma chamada para GetLastError. |
Observação
Não há rotina de retorno de chamada de gabinete padrão; Portanto, você deve fornecer uma rotina de retorno de chamada para lidar com as notificações enviadas por SetupIterateCabinet.
Comentários
Se a rotina de retorno de chamada retornar NO_ERROR, SetupIterateCabinet verificará o buffer apontado por Param2. Se o buffer não estiver vazio, ele conterá um novo caminho de origem. Se o buffer estiver vazio, o caminho de origem será considerado inalterado.
Sua função de retorno de chamada deve garantir que o gabinete esteja acessível antes de retornar, chamando a função SetupPromptForDisk , se a nova mídia precisar ser inserida.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2003 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|