Condividi tramite


FSCTL_GET_OBJECT_ID IOCTL (winioctl.h)

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

Per eseguire questa operazione, chiamare la funzioneDeviceIoControlcon i parametri seguenti.

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

Osservazioni:

Gli identificatori di oggetto vengono usati per tenere traccia di file e directory. Sono invisibili alla maggior parte delle applicazioni e non devono mai essere modificate dalle applicazioni. La modifica di un identificatore di oggetto può comportare 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, non viene creato alcun oggetto e viene restituito un errore. Per recuperare un identificatore di oggetto esistente o generarne uno se non esiste un identificatore di oggetto esistente in un unico passaggio, usare FSCTL_CREATE_OR_GET_OBJECT_ID. Per assegnare manualmente un identificatore di oggetto, usare FSCTL_SET_OBJECT_ID.

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

Tecnologia Sostenuto
Protocollo SMB (Server Message Block) 3.0
Failover trasparente (TFO) SMB 3.0
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO)
File system di volumi condivisi cluster (CsvFS)
Resilient File System (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)

Vedere anche