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 für das Dateiobjekt nicht bereits festgelegt (oder gelöscht) ist, wie durch den parameter Remote 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) wurde, gibt IoSetFileOrigin STATUS_INVALID_PARAMETER_MIX zurück und legt das Flag nicht fest oder löscht sie nicht.
Bemerkungen
Netzwerkdateisysteme rufen IoSetFileOrigin- auf, um das FO_REMOTE_ORIGIN Flag für das Dateiobjekt festzulegen oder zu löschen, auf das durch FileObjectverwiesen wird. Dieses Flag ist so festgelegt, dass das Dateiobjekt erstellt wurde, um eine Remoteerstellungsanforderung zu erfüllen.
Netzwerkdateisysteme sollten IoSetFileOrigin- auf ihren Servern aufrufen, damit alle Dateiobjekte, die erstellt werden, um eine Erstellungsanforderung von einem Netzwerkclient zu erfüllen.
Dateisystemfiltertreiber sollten nicht IoSetFileOrigin-aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Diese Routine ist unter Microsoft Windows XP und höher verfügbar. |
| Zielplattform- | Universal |
| Header- | ntddk.h (include Ntddk.h, Ntifs.h, Fltkernel.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | Beliebige Ebene |