ShellRegisterCallbacks

9/9/2008

Essa função registra funções callback através do qual a sistema operacional (OS) encaminha o SHAddToRecentDocs e Shell_NotifyIcon funções para um personalizado shell.

Syntax

BOOL ShellRegisterCallbacks(
  SHELLCALLBACKS* pShellCallbacks
);

Parameters

• pShellCallbacks
  [no] Ponteiro para um SHELLCALLBACKS estrutura que especifica as funções callback.

Return Value

TRUE indica sucesso. FALSE indica falha.

Remarks

Depois que você registrou as funções callback, o IsAPIReady função sempre retornará TRUE quando qualquer aplicativo chama IsAPIReady Com o sinalizador SH_SHELL.

Porque Windows Embedded CE não executa nenhum segmento alternando durante os retornos de chamada, o segmento pertence ao processo de cliente. Portanto, as funções callback devem executar somente uma quantidade mínima de processamento.

Normalmente, um função callback salva um copiar de dados de parâmetro e adia qualquer exigido processamento para separar um segmento que pertence o shell. O função callback deve totalmente copiar dados de parâmetro como qualquer ponteiros passado para o função callback são inválido em outro segmento ou em um callback posterior.

Requirements

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

See Also

Reference

SHAddToRecentDocs
Shell_NotifyIcon
SHELLCALLBACKS

Other Resources

IsAPIReady