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
E_ABORT
Der Vorgang wurde abgebrochen.
E_FAIL
Es ist ein unbekannter Fehler aufgetreten.
E_INVALIDARG
Einer der Parameter ist ungültig.
E_NOINTERFACE
Eine angegebene Schnittstelle wird nicht unterstützt.
E_NOTIMPL
Eine angegebene Methode ist nicht implementiert.
E_OUTOFMEMORY
Die -Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen.
E_POINTER
Ein als Parameter übergebener Zeiger ist ungültig.
E_UNEXPECTED
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

INetSharingConfiguration::D isableSharing

INetSharingConfiguration::get_SharingEnabled

Internetverbindungsfreigabe und Internetverbindungsfirewallschnittstellen

Internet Connection Sharing and Internet Connection Firewall Reference

SHARINGCONNECTIONTYPE