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)

Lihat juga

Antarmuka FSRM

FsrmSetting