SFVM_GETNOTIFY mensagem

Notificação enviada ao objeto de retorno de chamada de exibição para especificar os locais e eventos que devem ser registrados para eventos de notificação de alteração. Depois de registrados, quando ocorre uma alteração nesses locais ou eventos, o objeto de retorno de chamada de exibição é notificado. Esses eventos são enviados para o retorno de chamada de exibição por meio de SFVM_FSNOTIFY e, em seguida, são manipulados pela exibição.

SFVM_GETNOTIFY 

    wParam = (WPARAM)(LPITEMIDLIST*) pidl;

    lParam = (LPARAM)(LONG*) lEvents;

            

Parâmetros

pidl [out]

Um ponteiro para uma IDList absoluta de um item para o qual o modo de exibição deve se registrar para ser notificado sobre as alterações. Normalmente, isso é o mesmo que a IDList do local que está sendo exibido, mas pode ser outro local.

Importante

O tempo de vida desse valor pertence ao objeto de retorno de chamada de exibição. É responsabilidade do objeto de retorno de chamada de exibição criar e liberar esse valor quando ele não for mais necessário. Isso requer que o objeto de retorno de chamada de exibição armazene esse valor. Normalmente, o valor pode ser armazenado no membro _pidlMonitor do objeto de retorno de chamada de exibição. As regras de propriedade para o valor retornado por meio de pidl não são padrão e exigem cuidados especiais. O objeto de retorno de chamada de exibição deve possuir esse valor e garantir que ele não seja liberado até que o próprio objeto de retorno de chamada de exibição seja destruído.

 

lEvents [out]

Um valor que contém um ou mais valores SHCNE. Consulte SHChangeNotify para obter uma lista de valores possíveis. O objeto de retorno de chamada de exibição será registrado para receber uma mensagem de SFVM_FSNOTIFY quando qualquer um dos eventos associados ocorrer.

Valor retornado

Ignorado, mas deve retornar S_OK.

Comentários

Se essa mensagem de retorno de chamada não retornar um valor diferente de zero para a IDList ou a máscara de eventos, a exibição não será registrada para notificações de alteração.

Exemplos

O exemplo a seguir mostra um exemplo de implementação do código do manipulador da função de retorno de chamada de exibição para SFVM_GETNOTIFY.

case SFVM_GETNOTIFY:
  *((LPITEMIDLIST*)wParam) = _pidl;    // Pass a reference whose lifetime this 
                                       // class is responsible for.
                                      
  *((LONG*)lParam) = SHCNE_DISKEVENTS; // A combination of all of the 
                                       // disk event identifiers.
                                       
   return S_OK;

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Shlobj.h

Confira também

SFVM_QUERYFSNOTIFY

IShellFolderViewCB::MessageSFVCB