FSCTL_GET_OBJECT_ID IOCTL (winioctl.h)

  • Articolo

Recupera l'identificatore dell'oggetto per il file o la directory specificati.

Per eseguire questa operazione, chiamare la funzione DeviceIoControl con i parametri seguenti.

BOOL DeviceIoControl(
  (HANDLE) hDevice,           // handle to device
  FSCTL_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
);

Commenti

Gli identificatori di oggetto vengono usati per tenere traccia dei file e delle directory. Sono invisibili alla maggior parte delle applicazioni e non devono mai essere modificate dalle applicazioni. La modifica di un identificatore di oggetto può causare la perdita di dati da parti di un file, fino a e includere interi volumi di dati.

Se non è presente alcun identificatore di oggetto associato all'handle specificato, none viene creato e viene restituito un errore. Per creare un identificatore di oggetto, usare FSCTL_SET_OBJECT_ID. Per recuperare un identificatore di oggetto esistente o generarne uno se non è presente alcun identificatore di oggetto esistente in un unico passaggio, usare FSCTL_CREATE_OR_GET_OBJECT_ID.

In Windows 8 e Windows Server 2012 questo codice è supportato dalle tecnologie seguenti.

Tecnologia Supportato
Protocollo SMB (Server Message Block) 3.0 Sì
Failover trasparente SMB 3.0 (TFO) Sì
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO) Sì
File system del volume condiviso del cluster (CsvFS) Sì
File system resiliente (ReFS) No

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione winioctl.h (include Windows.h)

Vedi anche