estrutura CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT (ntifs.h)
A estrutura CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT contém o contexto de parâmetro de criação extra (ECP) que pode ser enviado para o sistema de arquivos CSV (Volumes Compartilhados clusterizados) para definir propriedades de como ele deve lidar com a E/S que chega nesta abertura.
Sintaxe
typedef struct _CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT {
SIZE_T Size;
ULONG PauseTimeoutInSeconds;
ULONG Flags;
} CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT, *PCSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT;
Membros
Size
Tamanho dessa estrutura, em bytes.
PauseTimeoutInSeconds
O número de segundos em que o CSVFS tem permissão para manter a E/S emitida neste objeto de arquivo em um estado pendente em caso de pausa de volume CSV. Depois que o tempo expirar, o CSV concluirá toda a E/S emitida neste objeto de arquivo com STATUS_CSV_IO_PAUSE_TIMEOUT de status. Esse membro pode ser um dos seguintes valores.
Valor | Significado |
---|---|
0xFFFFFFFF | Indica que não há tempo limite e o comportamento padrão é solicitado. |
0 | O CSV não pausará a E/S e concluirá a E/S imediatamente. |
Qualquer outro valor | O CSV arredondará todos os outros valores para vários de 10 segundos e usará esse valor como o tempo limite. O valor máximo de tempo limite com suporte é de 30 minutos. Se o valor fornecido for maior que 30 minutos, o CSV definirá silenciosamente o valor como o valor máximo. |
Flags
Os sinalizadores de propriedade set. Esse membro pode ser um OR bit a bit dos sinalizadores a seguir.
Bandeira | Significado |
---|---|
CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR | Informa ao CSVFS que esse arquivo aberto deve ser válido apenas no nó de coordenação. Se a abertura chegar ao CSVFS e o nó não for um nó de coordenação, a abertura falhará. Se o arquivo for aberto e o nó de coordenação for movido, o arquivo aberto será invalidado. Esse sinalizador é usado somente quando o arquivo é aberto diretamente no CSVFS e é ignorado quando o arquivo é aberto por SMB. |
Os 16 bits inferiores de Flags são para sinalizadores que fariam com que a criação falhasse com STATUS_INVALID_PARAMETER se o CSV não os reconhecesse. Os 16 bits superiores são para sinalizadores que seriam silenciosamente ignorados se o CSVFS não soubesse como lidar com eles.
Observações
O valor de GUID_ECP_CSV_SET_HANDLE_PROPERTIES 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 à criação extra de parâmetros para obter mais informações.
Requisitos
Requisito | Valor |
---|---|
de cliente com suporte mínimo | Windows 8 |
cabeçalho | ntifs.h |