Antarmuka IFsrmSetting (fsrm.h)
Digunakan untuk mengonfigurasi FSRM.
Untuk mendapatkan antarmuka ini, panggil fungsi CoCreateInstanceEx . Gunakan CLSID_FsrmSetting sebagai pengidentifikasi kelas dan __uuidof(IFsrmSetting)
sebagai pengidentifikasi antarmuka.
Warisan
Antarmuka IFsrmSetting mewarisi dari antarmuka IDispatch . IFsrmSetting juga memiliki jenis anggota ini:
Metode
Antarmuka IFsrmSetting memiliki metode ini.
IFsrmSetting::EmailTest Kirim pesan email ke alamat email yang ditentukan. |
IFsrmSetting::get_AdminEmail Mengambil atau mengatur alamat email untuk administrator. (Dapatkan) |
IFsrmSetting::get_DisableCommandLine Mengambil atau menetapkan nilai yang menentukan apakah FSRM mencegah tindakan baris perintah berjalan. (Dapatkan) |
IFsrmSetting::get_EnableScreeningAudit Mengambil atau menetapkan nilai yang menentukan apakah FSRM menyimpan catatan audit pelanggaran layar file. (Dapatkan) |
IFsrmSetting::get_MailFrom Mengambil atau mengatur alamat email default tempat pesan email dikirim. (Dapatkan) |
IFsrmSetting::get_SmtpServer Mengambil atau mengatur server SMTP yang digunakan FSRM untuk mengirim email. (Dapatkan) |
IFsrmSetting::GetActionRunLimitInterval Mendapatkan waktu tindakan yang menggunakan interval batas eksekusi global harus menunggu sebelum tindakan dijalankan lagi. |
IFsrmSetting::p ut_AdminEmail Mengambil atau mengatur alamat email untuk administrator. (Put) |
IFsrmSetting::p ut_DisableCommandLine Mengambil atau menetapkan nilai yang menentukan apakah FSRM mencegah tindakan baris perintah berjalan. (Put) |
IFsrmSetting::p ut_EnableScreeningAudit Mengambil atau menetapkan nilai yang menentukan apakah FSRM menyimpan catatan audit pelanggaran layar file. (Put) |
IFsrmSetting::p ut_MailFrom Mengambil atau mengatur alamat email default tempat pesan email dikirim. (Put) |
IFsrmSetting::p ut_SmtpServer Mengambil atau mengatur server SMTP yang digunakan FSRM untuk mengirim email. (Put) |
IFsrmSetting::SetActionRunLimitInterval Mengatur waktu tindakan yang menggunakan interval batas eksekusi global harus menunggu sebelum tindakan dijalankan lagi. |
Keterangan
Untuk membuat objek ini dari skrip, gunakan pengidentifikasi program, "Fsrm.FsrmSetting".
Contoh
Contoh berikut menunjukkan cara mengambil properti antarmuka ini.
#ifndef UNICODE
#define UNICODE
#endif
#include <windows.h>
#include <stdio.h>
#include <comutil.h>
#include <fsrm.h> // FSRM base objects and collections
#include <fsrmtlb_i.c> // contains CLSIDs
//
// Print the FSRM configuration settings.
//
void wmain(void)
{
HRESULT hr = 0;
IFsrmSetting* pSettings = NULL;
BSTR bstr = NULL;
VARIANT_BOOL boolVal = VARIANT_FALSE;
long interval = 0;
hr = CoInitializeEx(NULL, COINIT_APARTMENTTHREADED);
if (FAILED(hr))
{
wprintf(L"CoInitializeEx() failed, 0x%x.\n", hr);
exit(1);
}
hr = CoCreateInstance(CLSID_FsrmSetting,
NULL,
CLSCTX_LOCAL_SERVER,
__uuidof(IFsrmSetting),
reinterpret_cast<void**> (&pSettings));
if (FAILED(hr))
{
wprintf(L"CoCreateInstance(FsrmSetting) failed, 0x%x.\n", hr);
if (E_ACCESSDENIED == hr)
wprintf(L"Access denied. You must run the client with an elevated token.\n");
goto cleanup;
}
wprintf(L"Successfully created Setting object.\n");
// Get the default email address for the administrator. If set, you
// can then use the [Admin Email] macro for any action or report
// email address.
hr = pSettings->get_AdminEmail(&bstr);
if (FAILED(hr))
{
wprintf(L"pSettings->get_AdminEmail failed, 0x%x.\n", hr);
goto cleanup;
}
wprintf(L"AdminEmail: %s\n", bstr);
SysFreeString(bstr);
// Determines whether FSRM allows command actions to execute. The default
// is execute command actions.
hr = pSettings->get_DisableCommandLine(&boolVal);
if (FAILED(hr))
{
wprintf(L"pSettings->get_DisableCommandLine failed, 0x%x.\n", hr);
goto cleanup;
}
wprintf(L"DisableCommandLine: %s\n", (VARIANT_TRUE == boolVal) ? L"True" : L"False");
// Determines whether FSRM keeps audit records for file screen IO violations.
// The default is not to keep audit records.
hr = pSettings->get_EnableScreeningAudit(&boolVal);
if (FAILED(hr))
{
wprintf(L"pSettings->get_EnableScreeningAudit failed, 0x%x.\n", hr);
goto cleanup;
}
wprintf(L"EnableScreeningAudit: %s\n", (VARIANT_TRUE == boolVal) ? L"True" : L"False");
// The default address from which reports and email actions are sent.
// If set, you do not have to set the IFsrmActionEmail::MailFrom property.
// The default is FSRM@<localdomain>
hr = pSettings->get_MailFrom(&bstr);
if (FAILED(hr))
{
wprintf(L"pSettings->get_MailFrom failed, 0x%x.\n", hr);
goto cleanup;
}
wprintf(L"MailFrom: %s\n", bstr);
SysFreeString(bstr);
// Get the SMTP server. If not set, email is not sent.
hr = pSettings->get_SmtpServer(&bstr);
if (FAILED(hr))
{
wprintf(L"pSettings->get_SmtpServer failed, 0x%x.\n", hr);
goto cleanup;
}
wprintf(L"SmtpServer: %s\n", bstr);
SysFreeString(bstr);
// Each action can specify an interval to wait before executing the action again.
// The default for each action is 60 minutes.
wprintf(L"Default interval, in minutes, to wait between executing an action:\n");
hr = pSettings->GetActionRunLimitInterval(FsrmActionType_EventLog, &interval);
if (FAILED(hr))
{
wprintf(L"pSettings->GetActionRunLimitInterval(FsrmActionType_EventLog) failed, 0x%x.\n", hr);
goto cleanup;
}
wprintf(L"\tEventLog interval: %ld\n", interval);
hr = pSettings->GetActionRunLimitInterval(FsrmActionType_Email, &interval);
if (FAILED(hr))
{
wprintf(L"pSettings->GetActionRunLimitInterval(FsrmActionType_Email) failed, 0x%x.\n", hr);
goto cleanup;
}
wprintf(L"\tEmail interval: %ld\n", interval);
hr = pSettings->GetActionRunLimitInterval(FsrmActionType_Command, &interval);
if (FAILED(hr))
{
wprintf(L"pSettings->GetActionRunLimitInterval(FsrmActionType_Command) failed, 0x%x.\n", hr);
goto cleanup;
}
wprintf(L"\tCommand interval: %ld\n", interval);
hr = pSettings->GetActionRunLimitInterval(FsrmActionType_Report, &interval);
if (FAILED(hr))
{
wprintf(L"pSettings->GetActionRunLimitInterval(FsrmActionType_Report) failed, 0x%x.\n", hr);
goto cleanup;
}
wprintf(L"\tReport interval: %ld\n", interval);
hr = pSettings->put_SmtpServer(_bstr_t(L"<FQDNOFSMTPSERVER>"));
if (FAILED(hr))
{
wprintf(L"pSettings->put_SmtpServer failed, 0x%x.\n", hr);
goto cleanup;
}
cleanup:
if (pSettings)
pSettings->Release();
CoUninitialize();
}
Persyaratan
Klien minimum yang didukung | Tidak ada yang didukung |
Server minimum yang didukung | Windows Server 2008 |
Target Platform | Windows |
Header | fsrm.h (termasuk FsrmPipeline.h, FsrmQuota.h, FsrmReports.h, FsrmScreen.h, FsrmTlb.h) |