INetFwOpenPorts::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.]
Öffnet einen neuen Port und fügt ihn der Auflistung hinzu.
Syntax
HRESULT Add(
[in] INetFwOpenPort *port
);
Parameter
[in] port
Port, der der Auflistung hinzugefügt werden soll.
Rückgabewert
C++
| 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 der Port bereits geöffnet 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 |