IFsrmClassifierModuleImplementation::Metode OnBeginFile (fsrmpipeline.h)

Menginstruksikan pengklasifikasi untuk mempersiapkan pemrosesan file dengan tas properti yang ditentukan.

Sintaks

HRESULT OnBeginFile(
  [in] IFsrmPropertyBag *propertyBag,
  [in] SAFEARRAY        *arrayRuleIds
);

Parameter

[in] propertyBag

Tas properti yang sesuai dengan file yang akan diproses.

[in] arrayRuleIds

SAFEARRAY varian yang berisi satu atau beberapa string yang mencantumkan pengidentifikasi aturan yang akan diproses. Setiap pengidentifikasi sesuai dengan objek aturan yang ada dalam kumpulan aturan yang diteruskan oleh panggilan sebelumnya ke metode IFsrmClassifierModuleImplementation::UseRulesAndDefinitions . Objek aturan juga dapat diperoleh dengan menggunakan pengidentifikasi ini dalam panggilan ke metode IFsrmCollection::GetById pada koleksi ini.

Nilai kembali

Metode mengembalikan nilai pengembalian berikut. Pelaksana harus mengembalikan kode kesalahan HRESULT untuk kesalahan lainnya.

Keterangan

Pengklasifikasi tidak diizinkan untuk langsung memanggil IFsrmPropertyBag::SetFileProperty pada tas properti yang diteruskan. Pengklasifikasi menyediakan nilai properti ketika metode IFsrmClassifierModuleImplementation::D oesPropertyValueApply atau metode IFsrmClassifierModuleImplementation::GetPropertyValueToApply dipanggil oleh FSRM.

Setiap panggilan ke metode IFsrmClassifierModuleImplementation::D oesPropertyValueApply atau metode IFsrmClassifierModuleImplementation::GetPropertyValueToApply dikaitkan dengan aturan, pengidentifikasi yang diteruskan melalui parameter arrayRuleIds . Sebagai pengoptimalan, pengklasifikasi dapat secara opsional melakukan pra-komputasi respons untuk metode IFsrmClassifierModuleImplementation::D oesPropertyValueApply atau metode IFsrmClassifierModuleImplementation::GetPropertyValueToApply selama panggilan metode OnBeginFile menggunakan pengidentifikasi aturan yang diteruskan melalui parameter arrayRuleIds .

Jika FSRM_E_INCOMPATIBLE_FORMAT atau FSRM_E_FILE_ENCRYPTED dikembalikan, FSRM tidak akan menunjukkan bahwa file telah gagal klasifikasi. Jika ada nilai kesalahan lain yang dikembalikan, FSRM akan menunjukkan bahwa file telah gagal klasifikasi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Windows Server 2008 R2
Target Platform	Windows
Header	fsrmpipeline.h
DLL	SrmSvc.dll

Lihat juga

IFsrmClassifierModuleImplementation