Compartilhar via


SPFILENOTIFY_NEEDMEDIA mensagem

A notificação SPFILENOTIFY_NEEDMEDIA é enviada para a rotina de retorno de chamada quando uma nova mídia ou um novo arquivo de gabinete é necessário.

SPFILENOTIFY_NEEDMEDIA
  Param1 = (UINT) SourceMediaInfo;
  Param2 = (UINT) NewPathInfo;
            

Parâmetros

Param1

Ponteiro para uma estrutura SOURCE_MEDIA .

Param2

Ponteiro para uma matriz de caracteres para armazenar novas informações de caminho fornecidas pelo usuário. O tamanho do buffer é uma matriz TCHAR de elementos MAX_PATH. As informações de caminho retornadas pelo aplicativo de instalação não devem exceder esse tamanho.

Valor retornado

A rotina de retorno de chamada deve retornar uma das seguintes opções.

Código de retorno Descrição
FILEOP_NEWPATH
A mídia está presente e o arquivo solicitado está disponível no caminho especificado no buffer apontado por Param2.
FILEOP_SKIP
Ignorar o arquivo solicitado
FILEOP_ABORT
Anular processamento de fila. A função SetupCommitFileQueue retorna FALSE. GetLastError retorna informações de erro estendidas, como ERROR_CANCELLED se o usuário cancelou.
FILEOP-DOIT
A mídia está disponível.

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

SetupCommitFileQueue

SetupDefaultQueueCallback

SOURCE_MEDIA