Freigeben über

FSCTL_CREATE_OR_GET_OBJECT_ID IOCTL (winioctl.h)

Ruft den Objektbezeichner für die angegebene Datei oder das angegebene Verzeichnis ab. Wenn kein Objektbezeichner vorhanden ist, erstellt FSCTL_CREATE_OR_GET_OBJECT_ID einen.

Rufen Sie zum Ausführen dieses Vorgangs die DeviceIoControl--Funktion mit den folgenden Parametern auf.

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

Bemerkungen

Objektbezeichner werden zum Nachverfolgen von Dateien und Verzeichnissen verwendet. Sie sind für die meisten Anwendungen unsichtbar und sollten niemals von Anwendungen geändert werden. Das Ändern eines Objektbezeichners kann dazu führen, dass Daten aus Teilen einer Datei bis hin zu vollständigen Datenvolumes verloren gehen.

Bei diesem Vorgang wird ein Objektbezeichner erstellt, wenn das Objekt noch nicht über einen objektbezeichner verfügt. Verwenden Sie den FSCTL_GET_OBJECT_ID Vorgang, um das Vorhandensein eines Objektbezeichners zu testen und abzurufen, falls vorhanden. Verwenden Sie zum manuellen Zuweisen eines Objektbezeichners den FSCTL_SET_OBJECT_ID Vorgang.

In Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.

Technologie Unterstützt
Server Message Block (SMB) 3.0-Protokoll Ja
SMB 3.0 Transparentes Failover (TFO) Ja
SMB 3.0 mit Skalierungsdateifreigaben (SO) Ja
Freigegebenes Clustervolumedateisystem (CsvFS) Ja
Robustes Dateisystem (Resilient File System (ReFS)) Nein

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows XP [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2003 [Nur Desktop-Apps]
Überschrift winioctl.h (enthalten Windows.h)

Siehe auch