Share via


ShellRegisterCallbacks (Windows Embedded CE 6.0)

1/6/2010

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

Syntax

BOOL ShellRegisterCallbacks(
  SHELLCALLBACKS* pShellCallbacks
);

Parameters

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

Return Value

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 Embedded 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

Header shellcb.h
Library Shellcb.lib
Windows Embedded CE Windows CE 2.12 and later

See Also

Reference

Shell OS Functions
SHAddToRecentDocs
Shell_NotifyIcon
SHELLCALLBACKS

Other Resources

IsAPIReady