SHELLCALLBACKS

9/9/2008

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

Syntax

typedef struct {
  DWORD dwSize;
  PFNSHELL_NOTIFYICON pfnShell_NotifyIcon;
  PFNSHHADDTORECENTDOCS pfnSHAddToRecentDocs;
} SHELLCALLBACKS;

Os membros

• dwSize
  DWORD que especifica o tamanho dessa estrutura, em bytes. Você deve especificar um valor para esse membro.

• pfnShell_NotifyIcon
  Ponteiro para uma função callback aos quais o OS deve ENC o Shell_NotifyIcon função. O OS encaminha sempre Shell_NotifyIcon Para um personalizado shell se este função callback estiver presente. O seguinte exemplo de código mostra o protótipo para este função callback.

  typedef BOOL (WINAPI* PFNSHELL_NOTIFYICON)(DWORD dwMessage, 
                                             PNOTIFYICONDATA lpData);
  

• pfnSHAddToRecentDocs
  Ponteiro para uma função callback aos quais o OS deve ENC o SHAddToRecentDocs função. O OS encaminha sempre SHAddToRecentDocs Para um personalizado shell se este função callback estiver presente. O seguinte exemplo de código mostra o protótipo para este função callback.

  typedef void (WINAPI* PFNSHHADDTORECENTDOCS)(UINT uFlags, LPCVOID pv);
  

Remarks

Você deve registrar essas funções callback passando a SHELLCALLBACKS estrutura para o ShellRegisterCallbacks função.

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
Windows Embedded CE	Windows CE 2.12 and later

See Also

Reference

SHAddToRecentDocs
Shell_NotifyIcon
ShellRegisterCallbacks