FwpmvSwitchEventsGetSecurityInfo0-Funktion (fwpmu.h)
Die Funktion FwpmvSwitchEventsGetSecurityInfo0 ruft eine Kopie des Sicherheitsdeskriptors für ein vSwitch-Ereignis ab.
Syntax
DWORD FwpmvSwitchEventsGetSecurityInfo0(
[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*
Die Besitzersicherheits-ID (SID) im zurückgegebenen Sicherheitsdeskriptor.
[out] sidGroup
Typ: PSID*
Die primäre Gruppensicherheits-ID (SID) im zurückgegebenen Sicherheitsdeskriptor.
[out] dacl
Typ: PACL*
Die dacl (Discretionary Access Control List) im zurückgegebenen Sicherheitsdeskriptor.
[out] sacl
Typ: PACL*
Die Systemzugriffssteuerungsliste (SACL) im zurückgegebenen Sicherheitsdeskriptor.
[out] securityDescriptor
Typ: PSECURITY_DESCRIPTOR*
Der zurückgegebene Sicherheitsdeskriptor.
Rückgabewert
Art: DWORD
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Der Sicherheitsdeskriptor 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 durch einen Aufruf von FwpmFreeMemory0 freigegeben werden. Die anderen vier zurückgegebenen Parameter dürfen nicht freigegeben werden, da sie auf Adressen im SecurityDescriptor-Parameter verweisen.
Diese Funktion verhält sich wie die Standardmäßige Win32 GetSecurityInfo-Funktion . Der Aufrufer benötigt die gleichen Standardzugriffsrechte wie im Referenzthema GetSecurityInfo beschrieben.
FwpmvSwitchEventsGetSecurityInfo0 ist eine spezifische Implementierung von FwpmvSwitchEventsGetSecurityInfo. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und Spezifische Windows-Versionen .
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 |