Поделиться через

Функция AuditBrowserFileOperationEvent

  • Статья

Создает событие трассировки событий Windows для операций с файлами браузера.

Синтаксис

HRESULT WINAPI AuditBrowserFileOperationEvent(_In_z_ LPCWSTR source, _In_z_ LPCWSTR target, _In_z_ LPCWSTR actionType, BrowserType browserType, ::EventSource eventSource, DlpEnforcementLevel enforcementLevel, BOOLEAN userBypass, _In_ DlpTraceInfo* traceInfo, _In_z_ LPCWSTR targetDomain, _In_z_ LPCWSTR fileName, ULONGLONG lastModifiedTime, ULONGLONG fileSize, _In_z_ LPCWSTR printerOutputFileName, _In_z_ LPCWSTR printerName, _In_z_ LPCWSTR printerJobName);

Параметры

Некоторые параметры относятся к определенным типам действий. Дополнительные сведения см. в разделе "Примечания".

Общие параметры

source [in]: полный путь к целевому файлу.

target [in]: целевой объект для трассировки. Для некоторых операций без целевого объекта это значение может иметь значение NULL.

actionType [in]: тип действия веб-сайта для трассировки. См. возможные значения ниже в разделе Примечания.

browserType: тип браузера, используемый для трассировки события.

eventSource: сценарий, активировав трассировку события.

enforcementLevel: уровень принудительного применения указанного файла.

userbypass: указывает, что пользователь примет решение, DlpEnforcementLevel если для задано значение Предупреждать. Значение TRUE указывает, что операция разрешена, значение FALSE запрещает операцию.

userbypass [in]: указывает, что пользователь решает, DlpEnforcementLevel имеет ли значение Предупреждение. Значение TRUE указывает, что операция разрешена, значение FALSE запрещает операцию.

traceInfo [in]: ссылка на структуру трассировки. При успешном завершении эта структура содержит версию политики, используемую для оценки, и назначенную PolicyRuleID файлу. Это значение может иметь значение NULL.

Параметры для конкретных действий

targetDomain [in]: целевой домен.

fileName [in]: имя файла. Заполнено только в типе CloudEgress действия, в котором полный путь к файлу недоступен.

lastModifiedTime [in]: время последнего изменения файла. Заполнено только в типе CloudEgress действия, в котором полный путь к файлу недоступен.

fileSize [in]: размер файла. Заполнено только в типе CloudEgress действия, в котором полный путь к файлу недоступен.

printerOutputFileName [in]: имя выходного файла принтера.

printerName [in]: имя принтера.

printerJobName [in]: имя задания принтера.

Возвращаемое значение

Возвращает , HRESULT включая, помимо прочего, следующие значения.

HRESULT Описание
S_OK Функция успешно завершена.
FAILED Непредвиденная ошибка не позволила выполнить функцию.

Комментарии

Ниже приведены поддерживаемые actionType значения для этой функции и связанные необязательные параметры, ожидаемые функцией для каждого значения типа.

actionType Параметры для конкретных действий
CloudEgress targetDomain, fileName, lastModifiedTime, fileSize
Print PrinterOutputFileName, PrinterName, PrinterJobName

Эту функцию можно вызывать из нескольких потоков.

Требования

Требование Значение
Минимальная версия клиента
 Windows 11 версии 22H2 (10.0; Сборка 22621)
DLL
 EndpointDlp.dll