INetSharingConfiguration::EnableSharing-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 EnableSharing-Methode aktiviert die Freigabe für diese Verbindung.
Syntax
HRESULT EnableSharing(
[in] SHARINGCONNECTIONTYPE Type
);
Parameter
[in] Type
Gibt an, ob diese Verbindung öffentlich oder privat freigegeben wird.
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 abgebrochen. |
|
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
Wenn Sie diese Methode aufrufen, wird die folgende Benachrichtigung ausgelöst:
%programname% versucht, die Internetverbindungsfreigabe für die Netzwerkverbindung %connectionname% zu aktivieren. Dadurch können andere Computer in Ihrem Netzwerk über eine freigegebene öffentliche Verbindung eine Verbindung mit dem Internet herstellen. Soll %programname% die Internetverbindungsfreigabe für diese Verbindung aktivieren?
Wenn die aufrufende Anwendung angibt, dass diese Verbindung öffentlich freigegeben wird, wird jede vorherige öffentlich freigegebene Verbindung automatisch deaktiviert.
Für eine öffentlich freigegebene Verbindung ist automatisch die Internetverbindungsfirewall aktiviert. Privat freigegebene Verbindungen behalten ihre vorhandenen Einstellungen bei.
Verwenden Sie die INetSharingManager::get_INetSharingConfigurationForINetConnection-Methode , um eine INetSharingConfiguration-Schnittstelle für eine bestimmte Verbindung abzurufen.
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 isableSharing
INetSharingConfiguration::get_SharingEnabled
Internetverbindungsfreigabe und Internetverbindungsfirewallschnittstellen
Internet Connection Sharing and Internet Connection Firewall Reference