estrutura MARK_HANDLE_INFO32 (winioctl.h)
Contém informações que são usadas para marcar um arquivo ou diretório especificado e seu registro de diário de alteração usn (número de sequência de atualização) com dados sobre alterações. Isso só é definido para código de 64 bits e existe para interpretar MARK_HANDLE_INFO estruturas enviadas pelo código de 32 bits. Ele é usado pelo código de controle IOCTL FSCTL_MARK_HANDLE .
Sintaxe
typedef struct _MARK_HANDLE_INFO32 {
union {
DWORD UsnSourceInfo;
DWORD CopyNumber;
} DUMMYUNIONNAME;
DWORD UsnSourceInfo;
UINT32 VolumeHandle;
DWORD HandleInfo;
} MARK_HANDLE_INFO32, *PMARK_HANDLE_INFO32;
Membros
DUMMYUNIONNAME
DUMMYUNIONNAME.UsnSourceInfo
DUMMYUNIONNAME.CopyNumber
UsnSourceInfo
O tipo de alterações que estão sendo feitas.
A operação não modifica o arquivo ou diretório externamente do ponto de vista do aplicativo que o criou.
Quando um thread grava um novo registro USN, os sinalizadores de informações de origem no registro anterior só estarão presentes se o thread também definir esses sinalizadores. Portanto, a estrutura de informações de origem permite que os aplicativos filtrem registros USN definidos apenas por uma fonte conhecida, como um filtro antivírus.
Os valores a seguir são definidos.
| Valor | Significado |
|---|---|
|
A operação fornece informações sobre uma alteração no arquivo ou diretório feita pelo sistema operacional.
Um uso típico é quando o Armazenamento Remoto move dados do armazenamento externo para o local. O Armazenamento Remoto é o software de gerenciamento de armazenamento hierárquico. Esse movimento geralmente, no mínimo, adiciona o sinalizador USN_REASON_DATA_OVERWRITE a um registro usn. No entanto, os dados não foram alterados do ponto de vista do usuário. Observando USN_SOURCE_DATA_MANAGEMENT no membro SourceInfo da estrutura USN_RECORD que contém o registro, você pode determinar que, embora uma operação de gravação seja executada no item, os dados não foram alterados. |
|
A operação adiciona um fluxo de dados privado a um arquivo ou diretório.
Um exemplo pode ser um detector de vírus adicionando informações de soma de verificação. À medida que o detector de vírus modifica o item, o sistema gera registros USN. USN_SOURCE_AUXILIARY_DATA indica que as modificações não alteraram os dados do aplicativo. |
|
A operação cria ou atualiza o conteúdo de um arquivo replicado.
Por exemplo, o serviço de replicação de arquivos define esse sinalizador quando cria ou atualiza um arquivo em um diretório replicado. |
VolumeHandle
O identificador de volume para o volume em que o arquivo ou diretório reside. Para obter mais informações sobre como obter um identificador de volume, consulte a seção Comentários.
Esse identificador é necessário para verificar os privilégios dessa operação.
O chamador deve ter o privilégio SE_MANAGE_VOLUME_NAME . Para obter mais informações, consulte Privilégios.
HandleInfo
O sinalizador que especifica informações adicionais sobre o arquivo ou diretório identificado pelo valor do identificador no membro VolumeHandle .
| Valor | Significado |
|---|---|
|
O arquivo é marcado como não pode ser desfragmentado até que o identificador seja fechado. |
|
O arquivo é marcado como não pode ser desfragmentado até que o identificador seja fechado. |
|
O arquivo é marcado como não pode ser desfragmentado até que o identificador seja fechado. |
|
O arquivo é marcado para comportamento de leitura em tempo real, independentemente do tipo de arquivo real. Os arquivos marcados com esse sinalizador devem ser abertos para E/S não armazenada em buffer. |
|
O arquivo marcado anteriormente para comportamento de leitura em tempo real usando o sinalizador MARK_HANDLE_REALTIME pode ser não marcado usando esse sinalizador, removendo o comportamento em tempo real. Os arquivos marcados com esse sinalizador devem ser abertos para E/S não armazenada em buffer. |
Requisitos
| Cliente mínimo com suporte | Windows 8 (somente 64 bits) [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Cabeçalho | winioctl.h (inclua Windows.h) |