SHChangeNotification_Lock関数 (shlobj_core.h)

  • [アーティクル]

シェル変更通知イベントに関連付けられている共有メモリをロックします。

構文

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

パラメーター

[in] hChange

型: HANDLE

指定したシェル変更通知メッセージで wParam として受信したウィンドウへのハンドル。

dwProcId

型: DWORD

プロセス ID (メッセージ コールバックの lParam )。

[out, optional] pppidl

種類: PIDLIST_ABSOLUTE**

この関数が正常に返されたときに、影響を受ける PIDL の一覧を受け取るPIDLIST_ABSOLUTEへのポインターのアドレス。

[out, optional] plEvent

種類: LONG*

LONG 値へのポインター。この関数が正常に返されると、発生したイベントのシェル変更通知 ID を受け取ります。

戻り値

型: HANDLE

ロックされたメモリにハンドル (HLOCK) を返します。 完了したら、この値を SHChangeNotification_Unlock に渡します。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー shlobj_core.h (Shlobj.h を含む)
Library Shell32.lib
[DLL] Shell32.dll (バージョン 6.0 以降)
API セット ext-ms-win-shell-shell32-l1-2-1 (Windows 10 バージョン 10.0.10240 で導入)