SHChangeNotification_Lock-Funktion (shlobj_core.h)

Sperrt den freigegebenen Arbeitsspeicher, der einem Shell-Änderungsbenachrichtigungsereignis zugeordnet ist.

Syntax

HANDLE SHChangeNotification_Lock(
  [in]            HANDLE           hChange,
                  DWORD            dwProcId,
  [out, optional] PIDLIST_ABSOLUTE **pppidl,
  [out, optional] LONG             *plEvent
);

Parameter

[in] hChange

Typ: HANDLE

Ein Handle für ein Fenster, das in der angegebenen Shell-Änderungsbenachrichtigung als wParam empfangen wird.

dwProcId

Art: DWORD

Die Prozess-ID (lParam im Nachrichtenrückruf).

[out, optional] pppidl

Typ: PIDLIST_ABSOLUTE**

Die Adresse eines Zeigers auf einen PIDLIST_ABSOLUTE, der bei erfolgreicher Rückgabe dieser Funktion die Liste der betroffenen PIDLs empfängt.

[out, optional] plEvent

Typ: LONG*

Ein Zeiger auf einen LONG-Wert, der bei erfolgreicher Rückgabe dieser Funktion die Shell-Änderungsbenachrichtigungs-ID des ereignisses empfängt.

Rückgabewert

Typ: HANDLE

Gibt ein Handle (HLOCK) an den gesperrten Speicher zurück. Übergeben Sie diesen Wert an SHChangeNotification_Unlock , wenn Sie fertig sind.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj_core.h (einschließlich Shlobj.h)
Bibliothek	Shell32.lib
DLL	Shell32.dll (Version 6.0 oder höher)
APIs	ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240)