IPsecKeyManagerGetSecurityInfoByKey0 function (fwpmu.h)
The IPsecKeyManagerGetSecurityInfoByKey0 function retrieves a copy of the security descriptor that controls access to the key manager.
Syntax
DWORD IPsecKeyManagerGetSecurityInfoByKey0(
[in] HANDLE engineHandle,
const void *reserved,
[in] SECURITY_INFORMATION securityInfo,
[out, optional] PSID *sidOwner,
[out, optional] PSID *sidGroup,
[out, optional] PACL *dacl,
[out, optional] PACL *sacl,
[out] PSECURITY_DESCRIPTOR *securityDescriptor
);
Parameters
[in] engineHandle
Type: HANDLE
A handle to an open session to the filter engine. Call FwpmEngineOpen0 to open a session to the filter engine.
reserved
Type: const void*
Reserved. Must be set to NULL.
[in] securityInfo
Type: SECURITY_INFORMATION
The type of security information to retrieve.
[out, optional] sidOwner
Type: PSID*
The owner security identifier (SID) in the returned security descriptor.
[out, optional] sidGroup
Type: PSID*
The primary group security identifier (SID) in the returned security descriptor.
[out, optional] dacl
Type: PACL*
The discretionary access control list (DACL) in the returned security descriptor.
[out, optional] sacl
Type: PACL*
The system access control list (SACL) in the returned security descriptor.
[out] securityDescriptor
Type: PSECURITY_DESCRIPTOR*
The returned security descriptor.
Return value
Type: DWORD
Return code/value | Description |
---|---|
|
The security descriptor was successfully retrieved. |
|
A Windows Filtering Platform (WFP) specific error. See WFP Error Codes for details. |
|
Failure to communicate with the remote or local firewall engine. |
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 8 [desktop apps only] |
Minimum supported server | Windows Server 2012 [desktop apps only] |
Target Platform | Windows |
Header | fwpmu.h |
Library | Fwpuclnt.lib |
DLL | Fwpuclnt.dll |