INetSharingConfiguration::get_InternetFirewallEnabled-Methode (netcon.h)
[Die Internetverbindungsfirewall ist in nachfolgenden Versionen möglicherweise geändert oder nicht verfügbar. Verwenden Sie stattdessen die Windows-Firewall-API.]
Die get_InternetFirewallEnabled-Methode bestimmt, ob die Internetverbindungsfirewall für diese Verbindung aktiviert ist.
Syntax
HRESULT get_InternetFirewallEnabled(
[out] VARIANT_BOOL *pbEnabled
);
Parameter
[out] pbEnabled
Zeiger auf eine VARIANT_BOOL Variable, die bei erfolgreicher Rückgabe angibt, ob die Internetverbindungsfirewall aktiviert ist. Wenn die Internetverbindungsfirewall aktiviert ist, ist dieser Wert TRUE. Andernfalls ist es FALSE.
Rückgabewert
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 beendet. |
|
Es ist ein unbekannter Fehler aufgetreten. |
|
Einer der Parameter ist ungültig. |
|
Eine angegebene Schnittstelle wird nicht unterstützt. |
|
Eine angegebene Methode ist nicht implementiert. |
|
Die -Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen. |
|
Ein als Parameter übergebener Zeiger ist ungültig. |
|
Die Methode ist aus unbekannten Gründen fehlgeschlagen. |
Hinweise
Verwenden Sie die INetSharingManager::get_INetSharingConfigurationForINetConnection-Methode , um eine INetSharingConfiguration-Schnittstelle für eine bestimmte Verbindung abzurufen.
Windows XP mit SP2: Die resultierende Firewall status wird durch die Kombination von zwei Ebenen bestimmt: Überprüfen Sie zuerst den globalen Betriebsmodus, dann den Modus auf der relevanten Schnittstelle. Verwenden Sie das Verfahren Überprüfen des effektiven Firewallstatus , um den gesamtbetrieblichen Zustand zu ermitteln.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | netcon.h |
| DLL | Hnetcfg.dll |
Weitere Informationen
INetSharingConfiguration::D isableInternetFirewall
INetSharingConfiguration::EnableInternetFirewall
Internetverbindungsfreigabe und Internetverbindungsfirewallschnittstellen
Internet Connection Sharing and Internet Connection Firewall Reference