estrutura ECP_OPEN_PARAMETERS (ntifs.h)

  • Artigo

A estrutura ECP_OPEN_PARAMETERS contém o contexto ECP (parâmetros de criação extra) que permite que um chamador especifique a finalidade de abrir um arquivo sem interferir com identificadores existentes e/ou bloqueios oportunistas (oplocks) no arquivo.

Sintaxe

typedef struct _ECP_OPEN_PARAMETERS {
  USHORT Size;
  USHORT Reserved;
  ULONG  Flags;
} ECP_OPEN_PARAMETERS, *PECP_OPEN_PARAMETERS;

Membros

Size

Especifica o tamanho dessa estrutura de contexto, em bytes.

Reserved

Reservado para uso futuro. Isso deve ser inicializado como 0.

Flags

Sinalizadores que especificam os parâmetros ou a finalidade para abrir um arquivo. Os sinalizadores podem ser qualquer combinação dos seguintes valores:

Valor Descrição
ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_READ (0x0001) Abrindo o arquivo para lê-lo.
ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE (0x0002) Abrindo o arquivo para gravar nele.
ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_DELETE (0x0004) Abrindo o arquivo para excluí-lo.
ECP_OPEN_PARAMETERS_FLAG_IGNORE_DIR_CASE_SENSITIVITY (0x0008) Força uma pesquisa que não diferencia maiúsculas de minúsculas para esse arquivo aberta, mesmo em um diretório que diferencia maiúsculas de minúsculas. Disponível a partir do Windows 10, versão 2004.
ECP_OPEN_PARAMETERS_FLAG_FAIL_ON_CASE_SENSITIVE_DIR ( 0x0010) Falha ao abrir o arquivo ou criar solicitação se o caminho tiver diretórios sensíveis a maiúsculas e minúsculas. Disponível a partir do Windows 10, versão 2004.

Comentários

Os sinalizadores ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_READ e ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE permitem acesso de leitura/gravação a arquivos criptografados sem precisar realmente abrir esses arquivos para acesso de leitura/gravação. Esses sinalizadores ECP permitem que um componente do modo kernel seja aberto para acesso somente a metadados, não interferindo com outros acessos enquanto ainda recebe a configuração do contexto de criptografia para fazer leitura/gravação. Um filtro pode definir esses sinalizadores para evitar conflitos com o bloqueio. A configuração do estado de criptografia para operações de leitura/gravação é cara e normalmente não é feita quando os arquivos não são abertos para acesso de leitura/gravação.

O valor de GUID_ECP_OPEN_PARAMETERS definido pelo sistema é usado com essa estrutura de contexto ECP ao chamar rotinas de suporte relacionadas ao ECP, como FltAllocateExtraCreateParameter e FsRtlRemoveExtraCreateParameter.

Consulte Introdução a parâmetros de criação extra para obter mais informações.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1709.
Cabeçalho ntifs.h (inclua Ntifs.h)

Confira também

FltAllocateExtraCreateParameterList

FltCreateFileEx2