INetSharingConfiguration::AddPortMapping-Methode (netcon.h)

Artikel
03/06/2024

[Die Internetverbindungsfirewall ist in nachfolgenden Versionen möglicherweise geändert oder nicht verfügbar. Verwenden Sie stattdessen die Windows-Firewall-API.]

Die AddPortMapping-Methode fügt eine Dienstportzuordnung für diese Verbindung hinzu.

Syntax

HRESULT AddPortMapping(
  [in]  BSTR                   bstrName,
  [in]  UCHAR                  ucIPProtocol,
  [in]  USHORT                 usExternalPort,
  [in]  USHORT                 usInternalPort,
  [in]  DWORD                  dwOptions,
  [in]  BSTR                   bstrTargetNameOrIPAddress,
  [in]  ICS_TARGETTYPE         eTargetType,
  [out] INetSharingPortMapping **ppMapping
);

Parameter

[in] bstrName

Zeiger auf eine BSTR-Variable , die den Namen für diese Portzuordnung enthält.

[in] ucIPProtocol

Gibt das IP-Protokoll an, das für die Portzuordnung festgelegt werden soll. Das IP-Protokoll ist einer der folgenden Werte:

NAT_PROTOCOL_TCP

NAT_PROTOCOL_UDP

[in] usExternalPort

Gibt den externen Port für diese Portzuordnung an.

[in] usInternalPort

Gibt den internen Port für diese Portzuordnung an.

[in] dwOptions

Dieser Parameter ist reserviert und wird derzeit nicht verwendet.

[in] bstrTargetNameOrIPAddress

Zeiger auf eine BSTR-Variable , die den Namen des Zielcomputers für diese Portzuordnung enthält. Geben Sie entweder den Zielnamen oder die Ziel-IP-Adresse an, aber nicht beides.

[in] eTargetType

Gibt den Zieltyp an.

[out] ppMapping

Zeiger auf einen Zeiger, der bei erfolgreicher Rückgabe auf eine INetSharingPortMapping-Schnittstelle für die Portzuordnung verweist.

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

Beim ersten Hinzufügen befindet sich die neue Zuordnung im deaktivierten Zustand. Verwenden Sie INetSharingPortMapping::Enable, um die neue Zuordnung zu aktivieren.

Nach dem Hinzufügen wird die neue Definition in der Liste Portzuordnungen auf der ICS/ICF-Benutzeroberfläche angezeigt.

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

Internetverbindungsfreigabe und Internetverbindungsfirewallschnittstellen

Internet Connection Sharing and Internet Connection Firewall Reference

Freigeben über