estrutura LOOKUP_STREAM_FROM_CLUSTER_ENTRY (winioctl.h)

  • Artigo

Retornado do código de controle FSCTL_LOOKUP_STREAM_FROM_CLUSTER. Zero ou mais dessas estruturas seguem a estrutura LOOKUP_STREAM_FROM_CLUSTER_OUTPUT no buffer de saída retornado.

Sintaxe

typedef struct _LOOKUP_STREAM_FROM_CLUSTER_ENTRY {
  DWORD         OffsetToNext;
  DWORD         Flags;
  LARGE_INTEGER Reserved;
  LARGE_INTEGER Cluster;
  WCHAR         FileName[1];
} LOOKUP_STREAM_FROM_CLUSTER_ENTRY, *PLOOKUP_STREAM_FROM_CLUSTER_ENTRY;

Membros

OffsetToNext

Deslocamento em bytes do início dessa estrutura para o próximo LOOKUP_STREAM_FROM_CLUSTER_ENTRY estrutura retornada. Se não houver mais entradas, esse valor será zero.

Flags

Sinalizadores que descrevem características sobre esse fluxo. O valor consistirá em um ou mais desses valores. Pelo menos um dos valores de LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_* que se enquadram no LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_MASK (0xff000000) será definido; um ou mais dos outros valores de sinalizador podem ser definidos.

Valor Significado
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_PAGE_FILE
0x00000001
 O fluxo faz parte do arquivo de página do sistema.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_DENY_DEFRAG_SET
0x00000002
 O fluxo está bloqueado de desfragmentação. O membro HandleInfo da [estrutura MARK_HANDLE_INFO](ns-winioctl-mark_handle_info.md) para esse fluxo tem o sinalizador MARK_HANDLE_PROTECT_CLUSTERS definido.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_FS_SYSTEM_FILE
0x00000004
 O fluxo faz parte de um arquivo interno para o sistema de arquivos.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_TXF_SYSTEM_FILE
0x00000008
 O fluxo faz parte de um arquivo interno para TxF.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_DATA
0x01000000
 O fluxo faz parte de um atributo $DATA para o arquivo (fluxo de dados).
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_INDEX
0x02000000
 O fluxo faz parte do atributo $INDEX_ALLOCATION para o arquivo.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_SYSTEM
0x03000000
 O fluxo faz parte de outro atributo para o arquivo.

Reserved

Esse valor é reservado e atualmente é zero.

Cluster

Esse é o cluster ao qual essa entrada se refere. Ele será um dos clusters passados na estrutura de entrada.

FileName[1]

Uma cadeia de caracteres Unicode terminada em NULL que contém o caminho do objeto em relação à raiz do volume. Essa cadeia de caracteres se referirá ao atributo ou fluxo representado pelo cluster. Essa cadeia de caracteres não é limitada por MAX_PATH e pode ter até 32.768 caracteres (65.536 bytes) de comprimento. Nem todos os nomes de arquivo retornados podem ser abertos; alguns são internos para o NTFS e sempre abertos exclusivamente. A cadeia de caracteres retornada inclui o caminho completo, incluindo nome de arquivo, nome do fluxo e nome do tipo de atributo no formulário "caminho\completo\para\filename.ext\:streamname:typename".

Comentários

O nome no membro FileName pode ser muito longo e em um formato não reconhecido por um cliente com o nome do fluxo e o nome do tipo de atributo seguindo o nome do arquivo. Embora seja apropriado registrar o nome de arquivo inteiro para fins de diagnóstico, se ele for apresentado a um usuário final, ele deverá ser reformatado para ser mais compreensível (por exemplo, remover o nome do tipo de atributo e, se o membro Flags tiver qualquer sinalizador diferente de LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_DATA definido, uma mensagem apropriada deverá ser exibida.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho winioctl.h (inclua Windows.h)

Confira também

FSCTL_LOOKUP_STREAM_FROM_CLUSTER

LOOKUP_STREAM_FROM_CLUSTER_OUTPUT

Estruturas de gerenciamento de volumes