ShellRegisterCallbacks (Windows CE 5.0)
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
Send Feedback on this topic to the authors