IEnumNetSharingPortMapping::Next method (netcon.h)

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

The Next method retrieves the specified number of port mappings that start from the current enumeration position.

Syntax

HRESULT Next(
  [in]  ULONG   celt,
  [out] VARIANT *rgVar,
  [out] ULONG   *pceltFetched
);

Parameters

[in] celt

Specifies the number of port mappings to retrieve.

[out] rgVar

Pointer to a VARIANT variable for the port mapping. This variant contains a pointer to an INetSharingPortMapping interface.

[out] pceltFetched

Pointer to a ULONG variable that, on successful return, specifies the number of port mappings actually returned.

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.

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

IEnumNetSharingPortMapping

Internet Connection Sharing and Internet Connection Firewall Interfaces

Internet Connection Sharing and Internet Connection Firewall Reference