ShellRegisterCallbacks

  • Article

This function registers callback functions through which the operating system (OS) forwards the SHAddToRecentDocs and Shell_NotifyIcon functions to a custom shell.

BOOL ShellRegisterCallbacks(
  SHELLCALLBACKS* pShellCallbacks
);

Parameters

  • pShellCallbacks
    [in] Pointer to a SHELLCALLBACKS structure that specifies the callback functions.

Return Values

TRUE indicates success. FALSE indicates failure.

Remarks

Once you have registered the callback functions, the IsAPIReady function always returns TRUE when any application calls IsAPIReady with the SH_SHELL flag.

Because Windows CE performs no thread switching during the callbacks, the thread belongs to the client process. Therefore, the callback functions should perform only a minimal amount of processing.

Typically, a callback function saves a copy of the parameter data and defers any required processing to a separate thread that belongs to the shell. The callback function must fully copy the parameter data because any pointers passed to the callback function are invalid on another thread or at a later callback.

Requirements

OS Versions: Windows CE 2.12 and later.
Header: Shellcb.h.
Link Library: Shellcb.lib.

See Also

IsAPIReady | SHAddToRecentDocs | Shell_NotifyIcon | SHELLCALLBACKS

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.