共用方式為

iNetSharingConfiguration：：AddPortMapping 方法 (netcon.h)

  • 發行項

[因特網連線防火牆可能會在後續版本中改變或無法使用。 請改用 Windows 防火牆 API。]

AddPortMapping 方法會為此連線新增服務埠對應。

語法

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
);

參數

[in] bstrName

包含此埠對應名稱的 BSTR 變數指標。

[in] ucIPProtocol

指定要為通訊埠對應設定的IP通訊協定。 IP 通訊協定是下列其中一個值：

NAT_PROTOCOL_TCP

NAT_PROTOCOL_UDP

[in] usExternalPort

指定這個埠對應的外部埠。

[in] usInternalPort

指定此埠對應的內部埠。

[in] dwOptions

此參數是保留的，目前不會使用。

[in] bstrTargetNameOrIPAddress

包含此埠對應之目標計算機名稱的 BSTR 變數指標。 指定目標名稱或目標IP位址，但不能同時指定兩者。

[in] eTargetType

表示目標類型。

[out] ppMapping

成功傳回的指標指向埠對應的 INetSharingPortMapping 介面。

傳回值

如果方法成功，傳回值會S_OK。

如果方法失敗，傳回值就是下列其中一個錯誤碼。

傳回碼 Description
E_ABORT
 作業已中止。
E_FAIL
 發生未指定的錯誤。
E_INVALIDARG
 其中一個參數無效。
E_NOINTERFACE
 不支援指定的介面。
E_NOTIMPL
 未實作指定的方法。
E_OUTOFMEMORY
 方法無法配置所需的記憶體。
E_POINTER
 傳遞為參數的指標無效。
E_UNEXPECTED
 方法因未知的原因而失敗。

備註

第一次新增時，新的對應處於停用狀態。 若要啟用新的對應，請使用 INetSharingPortMapping：：Enable。

新增之後，新的定義會出現在ICS/ICF使用者介面的 [埠對應] 清單中。

使用 INetSharingManager：：get_INetSharingConfigurationForINetConnection 方法來取得特定連線的 INetSharingConfiguration 介面。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 netcon.h
Dll Hnetcfg.dll

另請參閱

INetSharingConfiguration

因特網聯機共用和因特網聯機防火牆介面

因特網聯機共用和因特網聯機防火牆參考