FSCTL_GET_OBJECT_ID IOCTL (winioctl.h)

  • Artikel

Ruft den Objektbezeichner für die angegebene Datei oder das angegebene Verzeichnis ab.

Um diesen Vorgang auszuführen, rufen Sie die Funktion DeviceIoControl mit den folgenden Parametern auf.

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

Hinweise

Objektbezeichner werden verwendet, um Dateien und Verzeichnisse nachzuverfolgen. Sie sind für die meisten Anwendungen unsichtbar und sollten niemals von Anwendungen geändert werden. Das Ändern eines Objektbezeichners kann zum Verlust von Daten aus Teilen einer Datei führen, bis hin zu und einschließlich ganzer Datenmengen.

Wenn dem angegebenen Handle kein Objektbezeichner zugeordnet ist, wird keiner erstellt, und ein Fehler wird zurückgegeben. Verwenden Sie zum Erstellen eines Objektbezeichners FSCTL_SET_OBJECT_ID. Verwenden Sie FSCTL_CREATE_OR_GET_OBJECT_ID, um einen vorhandenen Objektbezeichner abzurufen oder zu generieren, wenn in einem Schritt kein Objektbezeichner vorhanden ist.

In Windows 8 und Windows Server 2012 wird dieser Code von den folgenden Technologien unterstützt.

Technologie Unterstützt
SMB 3.0-Protokoll (Server Message Block) Ja
SMB 3.0 Transparent Failover (TFO) Ja
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO) Ja
Dateisystem mit freigegebenen Clustervolumes (CsvFS) Ja
Robustes Dateisystem (Resilient File System, ReFS) No

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile winioctl.h (einschließlich Windows.h)

Weitere Informationen