Compartilhar via


FILECHANGEINFO

Windows Mobile SupportedWindows Embedded CE Supported

9/8/2008

Essa estrutura contém informações sobre um arquivo evento do sistema.

Syntax

struct _FILECHANGEINFO {
  DWORD cbSize;
  LONG wEventId;
  ULONG uFlags;
  DWORD dwItem1;
  DWORD dwItem2;
  DWORD dwAttributes;
  FILETIME ftModified;
  ULONG nFileSize;
} FILECHANGEINFO, *LPFILECHANGEINFO;

Os membros

  • cbSize
    Tamanho dessa estrutura.
  • wEventId
    Descreve o evento que ocorreu. Normalmente, apenas um evento é especificado em um tempo. Se more than um evento for especificado, os valores contidos na dwItem1 e dwItem2 membros devem ser o mesmo para todos os eventos especificados.

    A seguinte tabela mostra os valores possíveis. É possível definir o membro a um ou mais desses valores.

    Valor Descrição

    SHCNE_ASSOCCHANGED

    Não suportado.

    SHCNE_ATTRIBUTES

    Os atributos de um item ou pasta foram alteradas. SHCNF_PATH deve ser especificado na uFlags membro. O dwItem1 membro contém um ponteiro para uma matriz seqüência de caracteres que armazena o item ou pasta que foi alterado. O dwItem2 membro é reservado e deve ser definido como NULL.

    SHCNE_CREATE

    Um item non-Folder foi criado. SHCNF_PATH deve ser especificado em uFlags. O dwItem1 membercontains um ponteiro para uma matriz seqüência de caracteres que armazena o item que foi criado. O dwItem2 membro não é usado e deve ser definido como NULL.

    SHCNE_DELETE

    Um item non-Folder foi excluído. SHCNF_PATH deve ser especificado em uFlags. O dwItem1 membro contém um ponteiro para uma matriz seqüência de caracteres que armazena o item que foi excluído. O dwItem2 membro é reservado e deve ser definido como NULL.

    SHCNE_DRIVEADD

    Uma unidade foi adicionada. SHCNF_PATH deve ser especificado em uFlags. O dwItem1 membro contém um ponteiro para uma matriz seqüência de caracteres que armazena a raiz da unidade que foi adicionada. O dwItem2 membro é reservado e deve ser definido como NULL.

    SHCNE_DRIVEADDGUI

    Uma unidade tenha sido adicionada, e o shell deve criar uma nova janela para a unidade. SHCNF_PATH deve ser especificado em uFlags. O dwItem1 membro contém um ponteiro para uma matriz seqüência de caracteres que armazena a raiz da unidade que foi adicionada. O dwItem2 membro é reservado e deve ser definido como NULL.

    SHCNE_DRIVEREMOVED

    Uma unidade foi removida. SHCNF_PATH deve ser especificado em uFlags. O dwItem1 membro contém um ponteiro para uma matriz seqüência de caracteres que armazena a raiz da unidade que foi removida. O dwItem2 membro é reservado e deve ser definido como NULL.

    SHCNE_MEDIAINSERTED

    Mídia de armazenamento foi inserida em uma unidade. SHCNF_PATH deve ser especificado em uFlags. O dwItem1 membro contém um ponteiro para uma matriz seqüência de caracteres que armazena a raiz da unidade que contém a nova mídia. O dwItem2 membro é reservado e deve ser definido como NULL.

    SHCNE_MEDIAREMOVED

    Mídia de armazenamento foi removida de uma unidade. SHCNF_PATH deve ser especificado em uFlags. O dwItem1 membro contém um ponteiro para uma matriz seqüência de caracteres que armazena a raiz da unidade a partir do qual a mídia foi removida. O dwItem2 membro é reservado e deve ser definido como NULL.

    SHCNE_MKDIR

    Uma pasta foi criada. SHCNF_PATH deve ser especificado em uFlags. O dwItem1 membro contém um ponteiro para uma matriz seqüência de caracteres que armazena a pasta que foi criada. O dwItem2 membro é reservado e deve ser definido como NULL.

    SHCNE_NETSHARE

    Uma pasta em de local computador está sendo compartilhado por meio de rede. SHCNF_PATH deve ser especificado em uFlags. O dwItem1 membro contém um ponteiro para uma matriz seqüência de caracteres que armazena a pasta que está sendo compartilhada. O dwItem2 membro é reservado e deve ser definido como NULL.

    Uma conexão foi feita para um servidor remoto.

    SHCNE_NETUNSHARE

    Uma pasta em de local computador não está sendo compartilhado por meio de rede. SHCNF_PATH deve ser especificado em uFlags. O dwItem1 membro contém um ponteiro para uma matriz seqüência de caracteres que armazena a pasta que está sendo compartilhada no longer. O dwItem2 membro é reservado e deve ser definido como NULL.

    Uma conexão para um servidor foi removido.

    SHCNE_RENAMEFOLDER

    O nome de uma pasta foi alterado. SHCNF_PATH deve ser especificado em uFlags. O dwItem1 membro contém um ponteiro para uma matriz seqüência de caracteres que armazena o nome anterior da pasta. O dwItem2 membro contém um ponteiro para uma matriz seqüência de caracteres que armazena o nome da pasta.

    SHCNE_RENAMEITEM

    O nome de um item non-Folder foi alterado. SHCNF_PATH deve ser especificado em uFlags. o dwItem1 membro contém um ponteiro para uma matriz seqüência de caracteres que armazena o nome do item. O dwItem2 membro contém um ponteiro para uma matriz seqüência de caracteres que armazena o novo nome do item.

    SHCNE_RMDIR

    Uma pasta foi removida. SHCNF_PATH deve ser especificado em uFlags. O dwItem1 membro contém um ponteiro para uma matriz seqüência de caracteres que armazena a pasta que foi removida. O dwItem2 membro é reservado e deve ser definido como NULL.

    SHCNE_SERVERDISCONNECT

    O computador foi desconectado de um servidor. SHCNF_PATH deve ser especificado em uFlags. O dwItem1 membro contém um ponteiro para uma matriz seqüência de caracteres que armazena o servidor do qual o computador foi desconectado. O dwItem2 membro é reservado e deve ser definido como NULL.

    SHCNE_UPDATEDIR

    O conteúdo de uma pasta existente tiver alterado, mas a pasta ainda existe e não tiver sido renomeada. SHCNF_PATH deve ser especificado em uFlags. O dwItem1 membro contém um ponteiro para uma matriz seqüência de caracteres que armazena a pasta que foi alterado. O dwItem2 membro é reservado e deve ser definido como NULL. Se uma pasta tiver sido criada, excluída ou renomeada, use SHCNE_MKDIR, SHCNE_RMDIR ou SHCNE_RENAMEFOLDER, em vez disso.

    SHCNE_UPDATEIMAGE

    Uma imagem em lista de imagens o sistema foi alterada. SHCNF_DWORD deve ser especificado em uFlags. O dwItem1 membro contém o índice no lista de imagens de sistema que foi alterado. O dwItem2 membro é reservado e deve ser definido como NULL.

    SHCNE_UPDATEITEM

    Um item non-Folder existente foi alterado, mas o item ainda existe e não tiver sido renomeado. SHCNF_PATH deve ser especificado em uFlags. O dwItem1 membro contém um ponteiro para uma matriz seqüência de caracteres que armazena o item que foi alterado. O dwItem2 memberis reservado e deve ser definida como NULL. Se um item non-Folder tenha sido criado, excluído ou renomeado, use SHCNE_CREATE, SHCNE_DELETE ou SHCNE_RENAMEITEM, em vez disso.

  • uFlags
    Os sinalizadores que indicam o significado do dwItem1 e o dwItem2 Os membros. A seguinte tabela mostra os valores possíveis.

    Valor Descrição

    SHCNF_DWORD

    O dwItem1 e o dwItem2 Os membros são DWORD Os valores. Este sinalizador não está com suporte.

    SHCNF_IDLIST

    O dwItem1 e o dwItem2 Os membros são os endereços de ITEMIDLIST estruturas que representam o item(s) afetados pela alteração. Cada ITEMIDLIST deve ser relativo para o área de trabalho pasta. Este sinalizador não está com suporte.

    SHCNF_PATH

    O dwItem1 e o dwItem2 Os membros são apontadores para matrizes seqüência de caracteres que contêm os nomes caminho completo os itens afetados pela alteração.

    SHCNF_PRINTER

    O dwItem1 e o dwItem2 Os membros são apontadores para matrizes seqüência de caracteres que representam o amigável nomes das impressoras afetadas pela alteração. Este sinalizador não está com suporte.

    A seguinte tabela mostra os sinalizadores que modificam outros dados-tipo sinalizadores. Esses sinalizadores não podem ser usados sem um dos valores descritos anteriormente.

    Valor Descrição

    SHCNF_FLUSHNOWAIT

    A função deve começar entrega notificações a todos os componentes afetados, mas deve retornam assim o processo notificação começou. Se este sinalizador não estiver definida, essa função não retorna até que a notificação tem sido entregue a todos os componentes afetados.

  • dwItem1

    For Windows Embedded CE:

    Primeiro evento-dependente valor.

    For Windows Mobile:

Valor Notification-specific que é dependente sobre o valor de uFlags. Se uFlags é SHCNF_PATH, o dwItem1 e o dwItem2 Os membros são apontadores para seqüências de caracteres que contêm os caminhos completos do item(s) afetados pela alteração.

  • dwItem2

    For Windows Embedded CE:

    Evento segundo-dependente valor.

    For Windows Mobile:

Valor Notification-specific que é dependente sobre o valor de uFlags. Se uFlags é SHCNF_PATH dwItem1 e dwItem2 Os ponteiros para as seqüências de caracteres que contêm os caminhos completos do item(s) são afetados pela alteração.

  • dwAttributes
    Atributos do arquivo, pasta ou item.
  • ftModified
    Tempo quando o evento ocorreu.
  • nFileSize
    Tamanho do arquivo, pasta ou item.

Remarks

For Windows Embedded CE:

Todos os memória exigido para essa estrutura deve ser alocado e liberado pelo driver de sistema de arquivos (FSD).

As seqüências de caracteres relatada voltar por FILECHANGEINFO são limitados a um comprimento MAX_PATH, incluindo NULL terminação, porque um arquivo com um nome mais MAX_PATH-1 não é possível existir.

Requirements

Header extfile.h, shlobj.h
Library ceshell.lib
Windows Embedded CE Windows CE 2.10 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

File I/O Structures

Other Resources