Compartilhar via


FSCTL_SET_INTEGRITY_INFORMATION IOCTL (winioctl.h)

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
);

Observações

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

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 levar à falha de leituras 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 a partir de 12 KB no arquivo, uma leitura falhará com ERROR_DATA_CHECKSUM_ERROR (0x143).

Requirements

Requirement Value
Cliente mínimo suportado Nenhum compatível
Servidor mínimo compatível Windows Server 2012 [somente aplicativos da área de trabalho]
Header winioctl.h (inclua Windows.h)

Consulte também