Fungsi IoCheckFileObjectOpenedAsCopySource (ntifs.h)

Artikel
03/01/2024

Rutinitas IoCheckFileObjectOpenedAsCopySource memeriksa apakah file sebelumnya dibuka dengan niat salin sebagai file sumber.

Sintaks

BOOLEAN IoCheckFileObjectOpenedAsCopySource(
  [in] PFILE_OBJECT FileObject
);

Parameter

[in] FileObject

Arahkan ke objek file sumber untuk memeriksa niat salin.

Mengembalikan nilai

IoCheckFileObjectOpenedAsCopySource mengembalikan TRUE jika objek file mewakili file sumber yang sebelumnya dibuka dengan niat salin file; jika tidak, ia mengembalikan FALSE. Nilai pengembalian TRUE hanya memberi sinyal niat pada waktu pembuatan; itu tidak berarti bahwa semua operasi pada objek file adalah bagian dari salinan.

Keterangan

Contoh berikut menunjukkan cara memeriksa apakah objek file dibuka dengan niat salin.


typedef  
BOOLEAN (*PIO_CHECK_FILE_OBJECT_OPENED_AS_COPY_SOURCE)( 
    _In_ PFILE_OBJECT FileObject 
); 
typedef  
BOOLEAN (*PIO_CHECK_FILE_OBJECT_OPENED_AS_COPY_DESTINATION)( 
    _In_ PFILE_OBJECT FileObject 
); 

PIO_CHECK_FILE_OBJECT_OPENED_AS_COPY_SOURCE IoCheckFileObjectOpenedAsCopySource; 
PIO_CHECK_FILE_OBJECT_OPENED_AS_COPY_DESTINATION IoCheckFileObjectOpenedAsCopyDestination;

// First resolve the API 
RtlInitUnicodeString(&RoutineName, L"IoCheckFileObjectOpenedAsCopySource"); 
IoCheckFileObjectOpenedAsCopySource = (PIO_CHECK_FILE_OBJECT_OPENED_AS_COPY_SOURCE)MmGetSystemRoutineAddress(&RoutineName); 

RtlInitUnicodeString(&RoutineName, L"IoCheckFileObjectOpenedAsCopyDestination"); 
IoCheckFileObjectOpenedAsCopyDestination = (PIO_CHECK_FILE_OBJECT_OPENED_AS_COPY_DESTINATION)MmGetSystemRoutineAddress(&RoutineName); 

// Now use the API 
IoCheckFileObjectOpenedAsCopySource(FltObjects->FileObject); 
IoCheckFileObjectOpenedAsCopyDestination(FltObjects->FileObject);

Lihat Penyalinan file mode kernel dan mendeteksi skenario salin file untuk informasi selengkapnya.