FwpmSubLayerGetSecurityInfoByKey0-Funktion (fwpmu.h)
Die Funktion FwpmSubLayerGetSecurityInfoByKey0 ruft eine Kopie des Sicherheitsdeskriptors für eine Teilschicht ab.
DWORD FwpmSubLayerGetSecurityInfoByKey0(
[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
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, optional] key
Typ: const GUID*
Eindeutiger Bezeichner der Unterschicht. Dies muss dieselbe GUID sein, die angegeben wurde, als die Anwendung FwpmSubLayerAdd0 aufgerufen hat.
[in] securityInfo
Typ: SECURITY_INFORMATION
Der Typ der abzurufenden Sicherheitsinformationen.
[out, optional] sidOwner
Typ: PSID*
Der Besitzersicherheitsbezeichner (Owner Security Identifier, SID) in der zurückgegebenen Sicherheitsbeschreibung.
[out, optional] sidGroup
Typ: PSID*
Die primäre Gruppensicherheits-ID (SID) im zurückgegebenen Sicherheitsdeskriptor.
[out, optional] dacl
Typ: PACL*
Die diskretionäre Zugriffssteuerungsliste (Discretionary Access Control List, DACL) in der zurückgegebenen Sicherheitsbeschreibung.
[out, optional] sacl
Typ: PACL*
Die Systemzugriffssteuerungsliste (System Access Control List, SACL) in der zurückgegebenen Sicherheitsbeschreibung.
[out] securityDescriptor
Typ: PSECURITY_DESCRIPTOR*
Der zurückgegebene Sicherheitsdeskriptor.
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. |
Wenn der SchlüsselparameterNULL ist oder eine NULL-GUID ist, verwaltet diese Funktion die Sicherheitsinformationen des Unterschichtcontainers.
Der zurückgegebene securityDescriptor-Parameter muss über einen Aufruf von FwpmFreeMemory0 freigegeben werden. Die anderen vier (optional) 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.
FwpmSubLayerGetSecurityInfoByKey0 ist eine spezifische Implementierung von FwpmSubLayerGetSecurityInfoByKey. Weitere Informationen finden Sie unter WFP Version-Independent Namen und Zielgruppenspezifische Windows-Versionen .
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | fwpmu.h |
Bibliothek | fwpuclnt.lib |
DLL | Fwpuclnt.dll |