GetNotificationSettingRequest-Struktur

Eine Anforderungsstruktur zum Senden von Benachrichtigungseinstellungsanforderungen. Die Anforderung gibt die Benachrichtigungseinstellungen und Zeichenfolgen für bestimmte Regel und Aktionstyp zurück.

Syntax

struct GetNotificationSettingRequest
{
    _Field_z_ LPCWSTR locale;
    DlpSerializedBuffer policyInfo;
    DlpActionType actionType;
    BOOLEAN isUnallowedBrowser;
    _Field_z_ LPCWSTR displayFilename;
    _Field_z_ LPCWSTR displayProcessName;
    _Field_z_ LPCWSTR jsonExtraInfo;
    DlpSerializedBuffer jsonNotification;
};

Elemente

Gebietsschema[IN]

Das abzurufende Sprachgebietsschema (z. B. "en-us"). Dieser Parameter ist erforderlich und sollte nicht leer sein.

policyInfo[IN]

Die Richtlinieninformationen, die von einer oder GetFileApplicationAccessRequest einer GetFileCloudApplicationPolicyRequest Richtlinienanforderung abgerufen wurden.

actionType[IN]

Der Aktionstyp für die Benachrichtigungsanforderung. Beachten Sie, dass, wenn DlpGetFileCloudApplicationPolicy verwendet wurde, actionType=DlpActionTypeCloudAppEgress.

isUnallowedBrowser[IN]

Gibt an, ob sich die Anwendung in der Liste der nicht zulässigen Browser befindet. Dies ist anders zu behandeln als bei einer nicht zugelassenen App. Für die Verwendung von Microsoft Defender.

displayFilename[IN]

Der anzuzeigende Dateiname. Es liegt bei dem Aufrufer, zu entscheiden, ob vollständiger Pfad oder nur Dateiname vorhanden ist. Trennen Sie sie für mehrere Dateien durch |. Dieser Parameter ist erforderlich und sollte nicht leer sein.

displayProcessName[IN]

Der benutzerfreundliche Prozess- oder App-Name, der angezeigt werden soll. Dieser Parameter ist erforderlich und sollte nicht leer sein.

jsonExtraInfo[IN][OPTIONAL]

JSON-Eingabe für zusätzliche Informationen.

jsonNotification[OUT]

Puffer, der die JSON-Benachrichtigungseinstellungen enthält. Muss mit DlpReleaseBuffer freigegeben werden.

Das jsonNotification-Schema ist wie folgt definiert:

{
  "title" : "<string>",       // notification title text
  "body" : "<string>",        // notification content text
  "showdropdown" : <bool>,    // flag to indicate if business justification dropdown should be shown
  "showtextbox" : <bool>,     // flag to indicate if business justification text box should be shown
  "dropdownlist" : [          // list of dropdown options to show
    {
      "id" : "<string>",      // internal id to use for reporting to sense/backend
      "text" : "<text>"       // text to for the dropdown option shown to the user
    },
    ...
  ]
}

Rückkehr

Gibt S_OK zurück, wenn dies erfolgreich ist, E_OUTOFMEMORY , wenn die Größe der Dropdownarray nicht groß genug ist oder andernfalls FEHLGESCHLAGEN ist.

Bemerkungen

Entspricht RequestIdGetNotificationSetting in DlpRequestId.

Anforderungen

Anforderung	Wert
Minimal unterstützter Client	Windows 11, Version 24H2 (Build 26100)
DLL	EndpointDlp.dll

Verwandte Inhalte

• DlpRequest