SFVM_GETNOTIFY訊息

傳送至檢視回呼物件的通知,以指定應該註冊變更通知事件的位置和事件。 註冊之後,當這些位置或事件發生變更時,就會通知檢視回呼物件。 這些事件會透過 SFVM_FSNOTIFY 傳送至檢視回呼,然後由檢視處理。

SFVM_GETNOTIFY 

    wParam = (WPARAM)(LPITEMIDLIST*) pidl;

    lParam = (LPARAM)(LONG*) lEvents;

            

參數

pidl [out]

檢視應該註冊以收到變更通知之專案的絕對 IDList 指標。 一般而言,這與所檢視位置的 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