IFsrmSetting-Schnittstelle (fsrm.h)
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) |
Weitere Informationen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für