FwpmProviderGetSecurityInfoByKey0 함수(fwpmu.h)

FwpmProviderGetSecurityInfoByKey0 함수는 공급자 개체에 대한 보안 설명자의 복사본을 검색합니다.

구문

DWORD FwpmProviderGetSecurityInfoByKey0(
  [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

형식: HANDLE

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

[in, optional] key

형식: const GUID*

관심 있는 개체의 고유 키입니다. 이 개체에 대해 애플리케이션이 FwpmProviderAdd0 을 호출할 때 지정한 것과 동일한 GUID여야 합니다.

[in] securityInfo

형식: SECURITY_INFORMATION

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

[out, optional] sidOwner

형식: PSID*

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

[out, optional] sidGroup

형식: PSID*

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

[out, optional] dacl

형식: PACL*

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

[out, optional] sacl

형식: PACL*

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

[out] securityDescriptor

형식: PSECURITY_DESCRIPTOR*

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

반환 값

형식:DWORD

설명

키 매개 변수가 NULL이거나 NULL GUID인 경우 이 함수는 공급자 컨테이너의 보안 정보를 관리합니다.

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

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

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

요구 사항

추가 정보

FwpmProviderSetSecurityInfoByKey0