Freigeben über

FSCTL_GET_OBJECT_ID IOCTL (winioctl.h)

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

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

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

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.

Wenn dem angegebenen Handle kein Objektbezeichner zugeordnet ist, wird keine erstellt, und es wird ein Fehler zurückgegeben. Verwenden Sie FSCTL_CREATE_OR_GET_OBJECT_ID, um einen vorhandenen Objektbezeichner abzurufen oder einen objektbezeichner in einem Schritt zu generieren. Um manuell einen Objektbezeichner zuzuweisen, verwenden Sie FSCTL_SET_OBJECT_ID.

In Windows 8 und Windows Server 2012 wird dieser Code 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