INetConnection::GetProperties method (netcon.h)

Article
10/13/2021

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

The GetProperties method retrieves a structure that contains the properties for this network connection.

Syntax

HRESULT GetProperties(
  [out] NETCON_PROPERTIES **ppProps
);

Parameters

[out] ppProps

Pointer to a pointer that, on successful return, points to a NETCON_PROPERTIES structure that contains the properties for this network connection.

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

The calling application should free the memory occupied by the NETCON_PROPERTIES structure returned by GetProperties. Free the memory by calling the NcFreeNetconProperties function. This function is defined in NetCon.h and is exported by NetShell.dll.

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