SFVM_GETNOTIFY сообщение

Уведомление, отправленное объекту обратного вызова представления для указания расположений и событий, которые должны быть зарегистрированы для событий уведомления об изменениях. После регистрации при изменении этих расположений или событий объект обратного вызова представления получает уведомление. Эти события отправляются в обратный вызов представления через SFVM_FSNOTIFY , а затем обрабатываются представлением.

SFVM_GETNOTIFY 

    wParam = (WPARAM)(LPITEMIDLIST*) pidl;

    lParam = (LPARAM)(LONG*) lEvents;

            

Параметры

pidl [out]

Указатель на абсолютный idList элемента, для которого представление должно быть зарегистрировано для уведомления об изменениях. Как правило, это то же самое, что и список идентификаторов просматриваемого расположения, но это может быть другое расположение.

Важно!

Время существования этого значения принадлежит объекту обратного вызова представления. Объект обратного вызова представления отвечает за создание и освобождение этого значения, когда оно больше не требуется. Для этого необходимо, чтобы объект обратного вызова представления сохранял это значение. Как правило, значение может храниться в _pidlMonitor элементе объекта обратного вызова представления. Правила владения для значения, возвращаемого через pidl , являются нестандартными и требуют особого ухода. Объект обратного вызова представления должен владеть этим значением и гарантировать, что оно не будет освобождено до тех пор, пока не будет уничтожен сам объект обратного вызова представления.

 

lEvents [out]

Значение типа , содержащее одно или несколько значений SHCNE. Список возможных значений см. в разделе SHChangeNotify . Объект обратного вызова представления зарегистрируется для получения сообщения SFVM_FSNOTIFY при возникновении любого из связанных событий.

Возвращаемое значение

Игнорируется, но должен возвращать S_OK.

Комментарии

Если это сообщение обратного вызова не возвращает ненулевое значение для IDList или маски событий, представление не будет зарегистрировано для уведомлений об изменениях.

Примеры

В следующем примере показан пример реализации кода обработчика функции обратного вызова представления для 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;

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Заголовок	Shlobj.h

См. также раздел

SFVM_QUERYFSNOTIFY

IShellFolderViewCB::MessageSFVCB