Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Wird zum Konfigurieren von FSRM verwendet.
Um diese Schnittstelle abzurufen, rufen Sie die Funktion CoCreateInstanceEx auf. Verwenden Sie CLSID_FsrmSetting als Klassenbezeichner und __uuidof(IFsrmSetting)
als Schnittstellenbezeichner.
Vererbung
Die IFsrmSetting-Schnittstelle erbt von der IDispatch-Schnittstelle . IFsrmSetting verfügt auch über folgende Arten von Membern:
Methoden
Die IFsrmSetting-Schnittstelle verfügt über diese Methoden.
IFsrmSetting::EmailTest Senden Sie eine E-Mail-Nachricht an die angegebene E-Mail-Adresse. |
IFsrmSetting::get_AdminEmail Ruft die E-Mail-Adresse für den Administrator ab oder legt sie fest. (Abrufen) |
IFsrmSetting::get_DisableCommandLine Ruft einen Wert ab, der bestimmt, ob FSRM die Ausführung von Befehlszeilenaktionen verhindert, oder legt diesen fest. (Abrufen) |
IFsrmSetting::get_EnableScreeningAudit Ruft einen Wert ab, der bestimmt, ob FSRM Überwachungsdatensätze der Dateibildschirmverletzungen speichert, oder legt diesen fest. (Abrufen) |
IFsrmSetting::get_MailFrom Ruft die Standard-E-Mail-Adresse ab, von der E-Mail-Nachrichten gesendet werden, oder legt diese fest. (Abrufen) |
IFsrmSetting::get_SmtpServer Ruft den SMTP-Server ab, den FSRM zum Senden von E-Mails verwendet, oder legt diesen fest. (Abrufen) |
IFsrmSetting::GetActionRunLimitInterval Ruft die Zeit ab, zu der eine Aktion, die das globale Ausführungslimitintervall verwendet, warten muss, bevor die Aktion erneut ausgeführt wird. |
IFsrmSetting::p ut_AdminEmail Ruft die E-Mail-Adresse für den Administrator ab oder legt sie fest. (Put) |
IFsrmSetting::p ut_DisableCommandLine Ruft einen Wert ab, der bestimmt, ob FSRM die Ausführung von Befehlszeilenaktionen verhindert, oder legt diesen fest. (Put) |
IFsrmSetting::p ut_EnableScreeningAudit Ruft einen Wert ab, der bestimmt, ob FSRM Überwachungsdatensätze der Dateibildschirmverletzungen speichert, oder legt diesen fest. (Put) |
IFsrmSetting::p ut_MailFrom Ruft die Standard-E-Mail-Adresse ab, von der E-Mail-Nachrichten gesendet werden, oder legt diese fest. (Put) |
IFsrmSetting::p ut_SmtpServer Ruft den SMTP-Server ab, den FSRM zum Senden von E-Mails verwendet, oder legt diesen fest. (Put) |
IFsrmSetting::SetActionRunLimitInterval Legt die Zeit fest, zu der eine Aktion, die das globale Ausführungslimitintervall verwendet, warten muss, bevor die Aktion erneut ausgeführt wird. |
Hinweise
Um dieses Objekt aus einem Skript zu erstellen, verwenden Sie den Programmbezeichner "Fsrm.FsrmSetting".
Beispiele
Das folgende Beispiel zeigt, wie die Eigenschaften dieser Schnittstelle abgerufen werden.
#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();
}
Anforderungen
Unterstützte Mindestversion (Client) | Nicht unterstützt |
Unterstützte Mindestversion (Server) | Windows Server 2008 |
Zielplattform | Windows |
Kopfzeile | fsrm.h (einschließlich FsrmPipeline.h, FsrmQuota.h, FsrmReports.h, FsrmScreen.h, FsrmTlb.h) |