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