INetSharingConfiguration::get_EnumPortMappings method (netcon.h)

Article
02/22/2024

[Internet Connection Firewall may be altered or unavailable in subsequent versions. Instead, use the Windows Firewall API.]

The get_EnumPortMappings method retrieves an IEnumNetSharingPortMapping interface. Use this interface to enumerate the port mappings for this connection.

Syntax

HRESULT get_EnumPortMappings(
  [in]  SHARINGCONNECTION_ENUM_FLAGS     Flags,
  [out] INetSharingPortMappingCollection **ppColl
);

Parameters

[in] Flags

This parameter must be ICSSC_DEFAULT.

[out] ppColl

Pointer to an interface pointer that, on successful return, points to a INetSharingPortMappingCollection interface.

Return value

If the method succeeds the return value is S_OK.

If the method fails, the return value is one of the following error codes.

Return code	Description
E_ABORT	The operation was aborted.
E_FAIL	An unspecified error occurred.
E_INVALIDARG	One of the parameters is invalid.
E_NOINTERFACE	A specified interface is not supported.
E_NOTIMPL	A specified method is not implemented.
E_OUTOFMEMORY	The method was unable to allocate required memory.
E_POINTER	A pointer passed as a parameter is not valid.
E_UNEXPECTED	The method failed for unknown reasons.

Remarks

Use the INetSharingManager::get_INetSharingConfigurationForINetConnection method to obtain an INetSharingConfiguration interface for a particular connection.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	netcon.h
DLL	Hnetcfg.dll