FSCTL_SET_INTEGRITY_INFORMATION IOCTL (winioctl.h)

  • Article

Récupère le statut d’intégrité d’un fichier ou d’un répertoire sur un volume ReFS.

Pour effectuer cette opération, appelez la fonction DeviceIoControl avec les paramètres suivants.

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

Remarques

Le status d’intégrité ne peut être modifié que pour les fichiers vides.

Si le ReplaceFile est utilisé pour remplacer un fichier par un jeu d’intégrité et que le paramètre lpBackupFileName pointe vers un emplacement qui n’a pas d’intégrité défini, l’intégrité status du fichier d’origine ne sera pas conservée.

Les écritures dans les flux d’intégrité sont toujours de taille cluster. Les lectures des flux d’intégrité sont toujours effectuées dans des blocs de 16 Ko. Cela peut entraîner l’échec des lectures même lorsque la zone endommagée se trouve en dehors de la région en cours de lecture. Par exemple, si 4 Ko est lu au décalage 0 dans un fichier et qu’un fichier est endommagé à partir de 12 Ko, une lecture échoue avec ERROR_DATA_CHECKSUM_ERROR (0x143).

Configuration requise

   
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
En-tête winioctl.h (inclure Windows.h)

Voir aussi