estrutura ECP_OPEN_PARAMETERS (ntifs.h)
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) |