IoSetFileOrigin-Funktion (ntddk.h)
Die IoSetFileOrigin-Routine gibt an, ob ein bestimmtes Dateiobjekt für eine Remoteerstellungsanforderung vorgesehen ist.
Syntax
NTSTATUS IoSetFileOrigin(
[in] PFILE_OBJECT FileObject,
[in] BOOLEAN Remote
);
Parameter
[in] FileObject
Zeiger auf das Dateiobjekt.
[in] Remote
Legen Sie auf TRUE fest, um das FO_REMOTE_ORIGIN-Flag für das Dateiobjekt festzulegen, false , um es zu löschen.
Rückgabewert
Wenn das FO_REMOTE_ORIGIN-Flag im Dateiobjekt nicht bereits festgelegt (oder gelöscht) ist, wie durch den Remote-Parameter angegeben, legt IoSetFileOrigin das Flag entsprechend fest oder löscht es und gibt STATUS_SUCCESS zurück.
Wenn das Flag bereits wie angegeben festgelegt (oder gelöscht) ist, gibt IoSetFileOrigin STATUS_INVALID_PARAMETER_MIX zurück und legt oder löscht das Flag nicht.
Hinweise
Netzwerkdateisysteme rufen IoSetFileOrigin auf, um das FO_REMOTE_ORIGIN Flag für das Dateiobjekt festzulegen oder zu löschen, auf das FileObject verweist. Dieses Flag wird festgelegt, um anzugeben, dass das Dateiobjekt erstellt wurde, um eine Remoteerstellungsanforderung zu erfüllen.
Netzwerkdateisysteme sollten IoSetFileOrigin auf ihren Servern für alle Dateiobjekte aufrufen, die erstellt werden, um eine Erstellungsanforderung von einem Netzwerkclient zu erfüllen.
Dateisystemfiltertreiber sollten IoSetFileOrigin nicht aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Diese Routine ist unter Microsoft Windows XP und höher verfügbar. |
| Zielplattform | Universell |
| Header | ntddk.h (include Ntddk.h, Ntifs.h, Fltkernel.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Beliebige Ebene |