estrutura NETWORK_OPEN_ECP_CONTEXT_V0 (ntifs.h)

Artigo
12/22/2024

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

Sintaxe

typedef struct _NETWORK_OPEN_ECP_CONTEXT_V0 {
  USHORT Size;
  USHORT Reserved;
  struct {
    struct {
      NETWORK_OPEN_LOCATION_QUALIFIER  Location;
      NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
    } in;
    struct {
      NETWORK_OPEN_LOCATION_QUALIFIER  Location;
      NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
    } out;
  } DUMMYSTRUCTNAME;
} NETWORK_OPEN_ECP_CONTEXT_V0, *PNETWORK_OPEN_ECP_CONTEXT_V0;

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é-criar) 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 NETWORK_OPEN_LOCATION_QUALIFIERdigitado que especifica a restrição de local a ser anexada ao arquivo.

DUMMYSTRUCTNAME.in.Integrity

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

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 NETWORK_OPEN_LOCATION_QUALIFIERdigitado que especifica a restrição de local a ser anexada ao arquivo.

DUMMYSTRUCTNAME.out.Integrity

No momento, esse membro não está implementado e deve ser ignorado.

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

Observações

Para obter informações sobre como usar ECPs para associar informações extras a um arquivo quando o arquivo for criado, consulte Usando parâmetros de criação extra com uma operação 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 System-Defined ECPs.

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

Na maioria dos casos, 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 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 em vez disso.