FILECHANGEINFO
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 |