FSCTL_SET_INTEGRITY_INFORMATION IOCTL (winioctl.h)

  • Artigo

Recupera o status de integridade de um arquivo ou diretório em um volume ReFS.

Para executar essa operação, chame a função DeviceIoControl com os parâmetros a seguir.

BOOL DeviceIoControl(
  (HANDLE) hDevice,                     // handle to file or directory
  FSCTL_SET_INTEGRITY_INFORMATION,      // dwIoControlCode
  (LPDWORD) pInBuffer,                  // FSCTL_SET_INTEGRITY_INFORMATION_BUFFER
  (DWORD) InBufferSize,                 // size of input buffer
  (LPDWORD) NULL,                       // pOutBuffer
  (DWORD) 0,                            // OutBufferSize
  (LPDWORD) NULL,                       // lpBytesReturned
  (LPOVERLAPPED) lpOverlapped           // OVERLAPPED structure
);

Comentários

A status de integridade só pode ser alterada para arquivos vazios.

Se ReplaceFile for usado para substituir um arquivo pelo conjunto de integridade e o parâmetro lpBackupFileName apontar para um local que não tenha integridade definida, a integridade status do arquivo original não será persistida.

Gravações em fluxos de integridade são sempre dimensionadas em cluster. As leituras de fluxos de integridade são sempre feitas em blocos de 16 KB. Isso pode fazer com que as leituras falhem mesmo quando a área corrompida está fora da região que está sendo lida. Por exemplo, se 4 KB for lido no deslocamento 0 em um arquivo e houver corrupção iniciando 12 KB no arquivo, uma leitura falhará com ERROR_DATA_CHECKSUM_ERROR (0x143).

Requisitos

   
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Cabeçalho winioctl.h (inclua Windows.h)

Confira também