Freigeben über

SHChangeNotification_Lock-Funktion (shlobj_core.h)

  • Artikel

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)