Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Функция FwpmEngineGetSecurityInfo0 извлекает копию дескриптора безопасности для обработчика фильтров.
Синтаксис
NTSTATUS FwpmEngineGetSecurityInfo0(
[in] HANDLE engineHandle,
[in] SECURITY_INFORMATION securityInfo,
[out] PSID *sidOwner,
[out] PSID *sidGroup,
[out] PACL *dacl,
[out] PACL *sacl,
[out] PSECURITY_DESCRIPTOR *securityDescriptor
);
Параметры
[in] engineHandle
Обработка открытого сеанса в обработчике фильтров. Вызовите FwpmEngineOpen0, чтобы открыть сеанс в обработчике фильтров.
[in] securityInfo
Тип извлекаемой информации безопасности.
[out] sidOwner
Идентификатор безопасности владельца (SID) в возвращаемом дескрипторе безопасности.
[out] sidGroup
Идентификатор безопасности основной группы (SID) в возвращаемом дескрипторе безопасности.
[out] dacl
Список управления доступом (DACL) в возвращаемом дескрипторе безопасности.
[out] sacl
Список управления доступом системы (SACL) в возвращаемом дескрипторе безопасности.
[out] securityDescriptor
Дескриптор возвращаемой безопасности.
Возвращаемое значение
| Возврат кода или значения | Описание |
|---|---|
|
ERROR_SUCCESS 0 |
Дескриптор безопасности был успешно получен. |
|
FWP_E_* код ошибки 0x80320001 — 0x80320039 |
Конкретная ошибка платформы фильтрации Windows (МПП). Дополнительные сведения см. в кодов ошибок МПП. |
| код ошибки RPC_* 0x80010001 — 0x80010122 |
Не удаляйте связь с подсистемой удаленного или локального брандмауэра. |
| другие коды NTSTATUS | Произошла ошибка. |
Замечания
Возвращаемый параметр securityDescriptor должен быть освобожден через вызов FwpmFreeMemory0. Остальные четыре возвращаемые параметры не должны быть освобождены, так как они указывают на адреса в параметре securityDescriptor.
Эта функция работает как стандартная функция Win32 GetSecurityInfo. Вызывающий объект должен иметь те же стандартные права доступа, что и в справочной статье GetSecurityInfo.
FwpmEngineGetSecurityInfo0 является конкретной реализацией FwpmEngineGetSecurityInfo. Дополнительные сведения см. в статье МПП Version-Independent имен и целевых версий Windows.
Требования
| Требование | Ценность |
|---|---|
| Минимально поддерживаемый клиент | Доступно начиная с Windows Vista. |
| целевая платформа | Всеобщий |
| Заголовок | fwpmk.h |
| библиотека | fwpkclnt.lib |
| IRQL | <= PASSIVE_LEVEL |