Функция WldpCanExecuteStream (wldp.h)

Запрашивает, разрешает ли политика выполнения выполнение кода в предоставленном потоке.

Синтаксис

HRESULT WldpCanExecuteStream(
  [in]           REFGUID                           host,
  [in]           WLDP_EXECUTION_EVALUATION_OPTIONS options,
                 IStream                           *stream,
  [in, optional] PCWSTR                            auditInfo,
  [out]          WLDP_EXECUTION_POLICY             *result
);

Параметры

[in] host

GUID, указывающий вызывающую программу. Список предварительно определенных GUID, которые можно использовать для этого параметра, см. в разделе Guids узла WLDP. Для узлов, для которых не определено определенное значение, используйте guid WLDP_HOST_GUID_OTHER.

[in] options

Значение из WLDP_EXECUTION_EVALUATION_OPTIONS , указывающее параметры для запроса авторизации выполнения.

stream

[in, optional] auditInfo

Строка, которая должна содержать соответствующую контекстную информацию, которую вызывающий объект должен использовать при отладке. Если запрос авторизации завершится сбоем, эта строка будет записана в журнал событий в разделе Applocker/MSI и Scripts/Operational. Вызывающие абоненты должны отметить, что, хотя размер AuditInfo не ограничен, размер строки должен быть меньше 4 КБ, так как она будет помещена в журнал событий.

[out] result

Получает указатель на значение из перечисления WLDP_EXECUTION_POLICY , указывающее результат политики выполнения запроса.

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

Возвращает S_OK об успешном выполнении, а в противном случае — код сбоя.

Комментарии

Этот метод предоставляется в качестве замены для WldpGetLockdownPolicy. Этот интерфейс отличается от WldpGetLockdownPolicy следующими способами:

• Рекомендует вызывающим абонентам гарантировать, что субъект (файл, буфер или поток) передает политику выполнения ос.
• Позволяет вызывающим приложениям предоставлять дополнительные сведения аудита для целей диагностики.
• Разрешает проверку буферов и потоков кода.
• Упрощает шаблон вызова.
• Поддерживает детализированные политики выполнения, например интерактивный режим в cmd или PowerShell.

Требования

Требование	Значение
Минимальная версия клиента	Windows 11, сборка 22621
Минимальная версия сервера	Windows 11, сборка 22621
Верхняя часть	wldp.h
Библиотека	wldp.lib
DLL	wldp.dll

См. также раздел

• WldpCanExecuteBuffer
• WldpCanExecuteFile