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 [僅限桌面應用程式] |
標頭 |
|
另請參閱