mensaje de SFVM_GETNOTIFY

Notificación enviada al objeto de devolución de llamada de vista para especificar las ubicaciones y eventos que se deben registrar para los eventos de notificación de cambios. Una vez registrados, cuando se produce un cambio en en estas ubicaciones o eventos, se notifica al objeto de devolución de llamada de vista. Estos eventos se envían a la devolución de llamada de vista a través de SFVM_FSNOTIFY y, a continuación, se controlan mediante la vista.

SFVM_GETNOTIFY 

    wParam = (WPARAM)(LPITEMIDLIST*) pidl;

    lParam = (LPARAM)(LONG*) lEvents;

            

Parámetros

pidl [out]

Puntero a un idlist absoluto de un elemento para el que la vista debe registrarse para recibir una notificación de los cambios. Normalmente, es lo mismo que idlist de la ubicación que se está viendo, pero puede ser otra ubicación.

Importante

La duración de este valor es propiedad del objeto de devolución de llamada de vista. Es responsabilidad del objeto de devolución de llamada de vista crear y liberar este valor cuando ya no sea necesario. Esto requiere que el objeto de devolución de llamada de vista almacene este valor. Normalmente, el valor se puede almacenar en el miembro _pidlMonitor del objeto de devolución de llamada de vista. Las reglas de propiedad del valor devuelto a través de pidl son no estándar y requieren un cuidado especial. El objeto de devolución de llamada de vista debe poseer este valor y asegurarse de que no se libere hasta que se destruya el propio objeto de devolución de llamada de vista.

 

lEvents [out]

Valor que contiene uno o varios valores SHCNE. Consulte SHChangeNotify para obtener una lista de los valores posibles. El objeto de devolución de llamada de vista se registrará para recibir un mensaje de SFVM_FSNOTIFY cuando se produzca cualquiera de los eventos asociados.

Valor devuelto

Se omite, pero debe devolver S_OK.

Comentarios

Si este mensaje de devolución de llamada no devuelve un valor distinto de cero para IDList o la máscara de eventos, la vista no se registrará para las notificaciones de cambio.

Ejemplos

En el ejemplo siguiente se muestra una implementación de ejemplo del código de controlador de la función de devolución de llamada de vista 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	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Shlobj.h

Consulte también

SFVM_QUERYFSNOTIFY

IShellFolderViewCB::MessageSFVCB