FwpmConnectionGetSecurityInfo0-Funktion (fwpmu.h)
Die FwpmConnectionGetSecurityInfo0-Funktion ruft eine Kopie des Sicherheitsdeskriptors für ein Verbindungsobjektänderungsereignis ab.
Syntax
DWORD FwpmConnectionGetSecurityInfo0(
[in] HANDLE engineHandle,
[in] SECURITY_INFORMATION securityInfo,
[out] PSID *sidOwner,
[out] PSID *sidGroup,
[out] PACL *dacl,
[out] PACL *sacl,
[out] PSECURITY_DESCRIPTOR *securityDescriptor
);
Parameter
[in] engineHandle
Typ: HANDLE
Handle für eine geöffnete Sitzung für die Filter-Engine. Rufen Sie FwpmEngineOpen0 auf, um eine Sitzung für die Filter-Engine zu öffnen.
[in] securityInfo
Typ: SECURITY_INFORMATION
Der Typ der abzurufenden Sicherheitsinformationen.
[out] sidOwner
Typ: PSID*
Der Besitzersicherheitsbezeichner (Owner Security Identifier, SID) in der zurückgegebenen Sicherheitsbeschreibung.
[out] sidGroup
Typ: PSID*
Die primäre Gruppensicherheits-ID (SID) im zurückgegebenen Sicherheitsdeskriptor.
[out] dacl
Typ: PACL*
Die diskretionäre Zugriffssteuerungsliste (Discretionary Access Control List, DACL) in der zurückgegebenen Sicherheitsbeschreibung.
[out] sacl
Typ: PACL*
Die Systemzugriffssteuerungsliste (System Access Control List, SACL) in der zurückgegebenen Sicherheitsbeschreibung.
[out] securityDescriptor
Typ: PSECURITY_DESCRIPTOR*
Der zurückgegebene Sicherheitsdeskriptor.
Rückgabewert
Art: DWORD
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Die Sicherheitsbeschreibung wurde erfolgreich abgerufen. |
|
Ein WFP-spezifischer Fehler (Windows Filtering Platform). Weitere Informationen finden Sie unter WFP-Fehlercodes . |
|
Fehler bei der Kommunikation mit der Remote- oder lokalen Firewall-Engine. |
Hinweise
Der zurückgegebene securityDescriptor-Parameter muss über einen Aufruf von FwpmFreeMemory0 freigegeben werden. Die anderen vier zurückgegebenen Parameter dürfen nicht freigegeben werden, da sie auf Adressen innerhalb des securityDescriptor-Parameters verweisen.
Diese Funktion verhält sich wie die Win32-Standardfunktion GetSecurityInfo . Der Aufrufer benötigt dieselben Standardzugriffsrechte wie im Referenzthema GetSecurityInfo beschrieben.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | fwpmu.h |
| Bibliothek | fwpuclnt.lib |
| DLL | Fwpuclnt.dll |