FwpmLayerGetSecurityInfoByKey0 함수(fwpmk.h)

FwpmLayerGetSecurityInfoByKey0 함수는 레이어 개체에 대한 보안 설명자의 복사본을 검색합니다.

통사론

NTSTATUS FwpmLayerGetSecurityInfoByKey0(
  [in]            HANDLE               engineHandle,
  [in, optional]  const GUID           *key,
  [in]            SECURITY_INFORMATION securityInfo,
  [out, optional] PSID                 *sidOwner,
  [out, optional] PSID                 *sidGroup,
  [out, optional] PACL                 *dacl,
  [out, optional] PACL                 *sacl,
  [out]           PSECURITY_DESCRIPTOR *securityDescriptor
);

매개 변수

[in] engineHandle

필터 엔진에 대한 열린 세션에 대한 핸들입니다. FwpmEngineOpen0 호출하여 필터 엔진에 대한 세션을 엽니다.

[in, optional] key

계층의 고유 식별자입니다. 가능한 GUID 값 목록은 필터링 계층 식별자 참조하세요.

[in] securityInfo

검색할 보안 정보의 유형입니다.

[out, optional] sidOwner

반환된 보안 설명자의 소유자 SID(보안 식별자)입니다.

[out, optional] sidGroup

반환된 보안 설명자의 기본 그룹 SID(보안 식별자)입니다.

[out, optional] dacl

반환된 보안 설명자의 DACL(임의 액세스 제어 목록)입니다.

[out, optional] sacl

반환된 보안 설명자의 SACL(시스템 액세스 제어 목록)입니다.

[out] securityDescriptor

반환된 보안 설명자입니다.

반환 값

발언

키 매개 변수가 NULL 경우 또는 NULL GUID인 경우 이 함수는 계층 컨테이너의 보안 정보를 관리합니다.

반환된 securityDescriptor 매개 변수는 FwpmFreeMemory0호출을 통해 해제되어야 합니다. 반환된 나머지 4개(선택 사항) 매개 변수는 securityDescriptor 매개 변수 내의 주소를 가리키므로 해제되지 않아야 합니다.

이 함수는 표준 Win32 GetSecurityInfo 함수처럼 동작합니다. 호출자는 GetSecurityInfo 참조 항목에 설명된 것과 동일한 표준 액세스 권한이 필요합니다.

FwpmLayerGetSecurityInfoByKey0FwpmLayerGetSecurityInfoByKey특정 구현입니다. 자세한 내용은 WFP Version-Independent 이름 및 특정 버전의 Windows 대상으로 지정을 참조하세요.

요구 사항

참고 항목

• FwpmFreeMemory0
• FwpmLayerSetSecurityInfoByKey0
• GetSecurityInfo
• 필터링 계층 식별자
• WFP 오류 코드
• WFP Version-Independent 이름 및 특정 버전의 Windows 대상으로 지정