FSCTL_SET_OBJECT_ID IOCTL (winioctl.h)
Legt den Objektbezeichner für die angegebene Datei oder das angegebene Verzeichnis fest.
Um diesen Vorgang auszuführen, rufen Sie die Funktion DeviceIoControl mit den folgenden Parametern auf.
BOOL DeviceIoControl(
(HANDLE) hDevice, // handle to device
FSCTL_SET_OBJECT_ID, // dwIoControlCode
(LPVOID) lpInBuffer, // input buffer
(DWORD) nInBufferSize, // size of input buffer
NULL, // lpOutBuffer
0, // nOutBufferSize
(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 bis hin zu ganzen Datenmengen führen.
Verwenden Sie diesen Vorgang, um einen Objektbezeichner explizit auf einen von Ihnen angegebenen Wert festzulegen. Der Versuch, einen Objektbezeichner für ein Objekt festzulegen, das bereits über einen Objektbezeichner verfügt, schlägt fehl. Ein Versuch, einen Objektbezeichner zu verwenden, der bereits auf dem Volume verwendet wird, schlägt ebenfalls fehl. Verwenden Sie den vorgang FSCTL_CREATE_OR_GET_OBJECT_ID , damit das NTFS-Dateisystem einen Objektbezeichner generiert, falls das Objekt noch keinen besitzt.
Beachten Sie, dass die Zeitstempel für eine Remotedatei möglicherweise nicht ordnungsgemäß aktualisiert werden. Um konsistente Ergebnisse zu gewährleisten, verwenden Sie ungepufferte E/A-Vorgänge.
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
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Kopfzeile | winioctl.h (windows.h einschließen) |