INetSharingConfiguration::get_EnumPortMappings method (netcon.h)
[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 |
|---|---|
|
The operation was aborted. |
|
An unspecified error occurred. |
|
One of the parameters is invalid. |
|
A specified interface is not supported. |
|
A specified method is not implemented. |
|
The method was unable to allocate required memory. |
|
A pointer passed as a parameter is not valid. |
|
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 |
See also
INetSharingConfiguration::AddPortMapping
INetSharingConfiguration::RemovePortMapping
INetSharingPortMappingCollection
Internet Connection Sharing and Internet Connection Firewall Interfaces
Internet Connection Sharing and Internet Connection Firewall Reference