INetFwOpenPorts::Remove-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.]
Schließt einen Port und entfernt ihn aus der Auflistung.
Syntax
HRESULT Remove(
[in] LONG portNumber,
[in] NET_FW_IP_PROTOCOL ipProtocol
);
Parameter
[in] portNumber
Zu entfernende Portnummer.
[in] ipProtocol
Protokoll des zu entfernenden Ports.
Rückgabewert
C++
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang wurde aufgrund von Berechtigungsproblemen abgebrochen. |
|
Die Methode ist aufgrund eines ungültigen Parameters fehlgeschlagen. |
|
Die Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen. |
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. |
|
Die Methode ist aufgrund eines ungültigen Parameters fehlgeschlagen. |
|
Die Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen. |
Hinweise
Wenn der Port bereits geschlossen ist, hat die Remove-Methode keine Auswirkung.
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 |