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 especifica um novo caminho para o gabinete.

Valor retornado

Sua rotina deve retornar um dos seguintes valores.

Código de retorno Descrição
NO_ERROR
Nenhum erro foi encontrado, continue processando o gabinete.
ERROR_XXX
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 padrão de retorno de chamada do gabinete; 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 pelo 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
Setupapi.h

Confira também

Visão geral

Notificações

CABINET_INFO

SetupIterateCabinet