ShellRegisterCallbacks

2/15/2013

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

Because Windows Embedded Compact 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

See Also

Reference

Shell OS Functions
SHAddToRecentDocs
SHELLCALLBACKS