estrutura NETWORK_OPEN_ECP_CONTEXT (ntifs.h)

Artigo
02/27/2024

A estrutura NETWORK_OPEN_ECP_CONTEXT é usada para interpretar contextos de parâmetro de criação extra de rede (ECP) em arquivos.

Sintaxe

typedef struct _NETWORK_OPEN_ECP_CONTEXT {
  USHORT Size;
  USHORT Reserved;
  struct {
    struct {
      NETWORK_OPEN_LOCATION_QUALIFIER  Location;
      NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
      NETWORK_OPEN_IN_FLAGS            Flags;
    } in;
    struct {
      NETWORK_OPEN_LOCATION_QUALIFIER  Location;
      NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
      NETWORK_OPEN_OUT_FLAGS           Flags;
    } out;
  } DUMMYSTRUCTNAME;
} NETWORK_OPEN_ECP_CONTEXT, *PNETWORK_OPEN_ECP_CONTEXT;

Membros

Size

O tamanho, em bytes, dessa estrutura.

Reserved

Reservado. Deve ser definido como zero.

DUMMYSTRUCTNAME

Uma estrutura que contém restrições a serem aplicadas para abrir o arquivo (pré-criação) e aplicar ao arquivo depois que ele for aberto (pós-criação).

DUMMYSTRUCTNAME.in

Estrutura que contém restrições de pré-criação para abrir um arquivo.

DUMMYSTRUCTNAME.in.Location

Um valor do tipo NETWORK_OPEN_LOCATION_QUALIFIER que especifica a restrição de localização a ser anexada ao arquivo.

DUMMYSTRUCTNAME.in.Integrity

Um valor do tipo NETWORK_OPEN_INTEGRITY_QUALIFIER que especifica a restrição de integridade a ser anexada ao arquivo.

DUMMYSTRUCTNAME.in.Flags

Com suporte a partir do Windows 7. Um valor que especifica atributos para o arquivo. Esse membro é um OR bit a bit de qualquer um dos sinalizadores a seguir.

Valor	Significado
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_COLLAPSING (0x1)	Indica ao redirecionador SMB que a solicitação aberta de entrada não deve ser recolhida e recolhida em um identificador aberto existente para o mesmo arquivo.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_DURABILITY (0x2)	Faz com que o redirecionador SMB2+ desabilite a durabilidade nesse identificador aberto. Para obter mais informações sobre como abrir um arquivo para operação durável, consulte Solicitações de aplicativo criando um arquivo aberto para operação durável.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_OPLOCKS (0x4)	Indica ao redirecionador SMB para não conceder oplocks para a solicitação aberta de entrada. Esse sinalizador está disponível a partir do Windows 8.
NETWORK_OPEN_ECP_IN_FLAG_FORCE_BUFFERED_SYNCHRONOUS_IO_HACK (0x80000000)	Reservado para uso interno e não deve ser usado por aplicativos. Esse sinalizador força o redirecionador a usar E/S síncrona, mesmo que o identificador tenha sido aberto para E/S assíncrona.

DUMMYSTRUCTNAME.out

Estrutura que contém restrições pós-criação a serem aplicadas a um arquivo após a abertura.

DUMMYSTRUCTNAME.out.Location

Um valor do tipo NETWORK_OPEN_LOCATION_QUALIFIER que especifica a restrição de localização a ser anexada ao arquivo.

DUMMYSTRUCTNAME.out.Integrity

Um valor do tipo NETWORK_OPEN_INTEGRITY_QUALIFIER que especifica a restrição de integridade a ser anexada ao arquivo.

DUMMYSTRUCTNAME.out.Flags

Com suporte a partir do Windows 7. Um valor que especifica atributos para o arquivo. Esse membro é um OR bit a bit de qualquer um dos sinalizadores a seguir.

Valor	Significado
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_COLLAPSING (0x1)	Indica ao redirecionador SMB que a solicitação aberta de entrada não deve ser recolhida e recolhida em um identificador aberto existente para o mesmo arquivo.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_DURABILITY (0x2)	Faz com que o redirecionador SMB2+ desabilite a durabilidade nesse identificador aberto. Para obter mais informações sobre como abrir um arquivo para operação durável, consulte Solicitações de aplicativo criando um arquivo aberto para operação durável.
NETWORK_OPEN_ECP_IN_FLAG_FORCE_BUFFERED_SYNCHRONOUS_IO_HACK (0x80000000)	Reservado para uso interno e não deve ser usado por aplicativos. Esse sinalizador força o redirecionador a usar E/S síncrona, mesmo que o identificador tenha sido aberto para E/S assíncrona.

Comentários

Para obter informações sobre como usar ECPs para associar informações extras a um arquivo quando o arquivo é criado, consulte Usando parâmetros de criação extra com uma operação de IRP_MJ_CREATE.

Um driver de filtro deve considerar a estrutura NETWORK_OPEN_ECP_CONTEXT como somente leitura, usando-a apenas para recuperar informações sobre o contexto ECP de rede em um arquivo. Para obter mais informações, consulte ECPs definidos pelo sistema.

Se um chamador precisar verificar se o sistema de arquivos reconheceu a estrutura de contexto NETWORK_OPEN_ECP_CONTEXT , o chamador deverá chamar a rotina FltIsEcpAcknowledged ou FsRtlIsEcpAcknowledged no ECP após a conclusão da operação.

Os drivers executados no Windows 7 e versões posteriores do Windows e que devem interpretar contextos ECP de rede em arquivos que residem no Windows Vista devem usar a estrutura NETWORK_OPEN_ECP_CONTEXT_V0 .

Os drivers executados no Windows Vista e versões posteriores do Windows usam a estrutura NETWORK_OPEN_ECP_CONTEXT para interpretar contextos ECP de rede em arquivos. No entanto, os membros DUMMYSTRUCTNAME.in.Flags e DUMMYSTRUCTNAME.out.Flags só têm suporte a partir do Windows 7.