INetFwAuthorizedApplications::Add-Methode (netfw.h)
[Die Windows-Firewall-API ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt "Anforderungen" angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Für Windows Vista und höher wird die Verwendung der Windows-Firewall mit erweiterter Sicherheits-API empfohlen.]
Die Add-Methode fügt der Auflistung eine neue Anwendung hinzu.
Syntax
HRESULT Add(
[in] INetFwAuthorizedApplication *app
);
Parameter
[in] app
| C++ | Anwendung, die der Auflistung über ein INetFWAuthorizedApplication-Objekt hinzugefügt werden soll. |
| VB | Anwendung, die der Auflistung über ein INetFWAuthorizedApplication-Objekt hinzugefügt werden soll. |
Rückgabewert
C++
Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK.Wenn die Methode fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang wurde aufgrund von Berechtigungsproblemen abgebrochen. |
|
Fehler bei der Methode, weil ein Parameter ungültig war. |
|
Die Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen. |
|
Bei der Methode ist ein Fehler aufgetreten, da sich das Objekt bereits in der Auflistung befindet. |
VB
Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK.Wenn die Methode fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang wurde aufgrund von Berechtigungsproblemen abgebrochen. |
|
Fehler bei der Methode, weil ein Parameter ungültig war. |
|
Die Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen. |
|
Bei der Methode ist ein Fehler aufgetreten, da sich das Objekt bereits in der Auflistung befindet. |
Hinweise
Wenn bereits eine Anwendung mit demselben Pfad vorhanden ist, werden die vorhandenen Einstellungen überschrieben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 mit SP1 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | netfw.h |
| DLL | FirewallAPI.dll; Hnetcfg.dll unter Windows XP mit SP2 |