FSCTL_CREATE_OR_GET_OBJECT_ID IOCTL (winioctl.h)

Récupère l’identificateur d’objet pour le fichier ou le répertoire spécifié. Si aucun identificateur d’objet n’existe, l’utilisation de FSCTL_CREATE_OR_GET_OBJECT_ID en crée une.

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

BOOL DeviceIoControl(
  (HANDLE) hDevice,              // handle to file
  FSCTL_CREATE_OR_GET_OBJECT_ID, // dwIoControlCode
  NULL,                          // lpInBuffer
  0,                             // nInBufferSize
  (LPVOID) lpOutBuffer,          // output buffer
  (DWORD) nOutBufferSize,        // size of output buffer
  (LPDWORD) lpBytesReturned,     // number of bytes returned
  (LPOVERLAPPED) lpOverlapped    // OVERLAPPED structure
);

Remarques

Les identificateurs d’objet sont utilisés pour suivre les fichiers et les répertoires. Elles sont invisibles pour la plupart des applications et ne doivent jamais être modifiées par les applications. La modification d’un identificateur d’objet peut entraîner la perte de données provenant de parties d’un fichier, jusqu’à l’intégralité des volumes de données.

Cette opération crée un identificateur d’objet si l’objet n’en a pas déjà un. Pour tester la présence d’un identificateur d’objet et le récupérer s’il existe, utilisez l’opération de FSCTL_GET_OBJECT_ID . Pour affecter manuellement un identificateur d’objet, utilisez l’opération de FSCTL_SET_OBJECT_ID .

Dans Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.

Spécifications

Voir aussi

• DeviceIoControl
• FILE_OBJECTID_BUFFER
• FSCTL_DELETE_OBJECT_ID
• FSCTL_GET_OBJECT_ID
• FSCTL_SET_OBJECT_ID
• FSCTL_SET_OBJECT_ID_EXTENDED
• Identificateurs d’objet