IAPI::GetNetworkConnectionList

property GetNetworkConnectionList.

Gets a list of Network Connection Names from within a computer.

HRESULT GetNetworkConnectionList(
 long activeOnly,
 BSTR *pVal
);

Parameters

activeOnly

[in, defaultvalue(1)]

. If 1 retrieves only active Network Connections (connected)

. If 0 retrieves only inactive Network Connections (disconnected)

. If -1 retrieves active and inactive Network Connections

pVal

[out, retval]

Returns a string of Network Connection Names which are separated with semicolon (;)

or NULL if not found. When not NULL, this string must be freed with FreeBSTR after use.

Return Values

S_OK

The operation was successfull.

E_POINTER

A NULL pointer was supplied as an argument.

E_UNEXPECTED

An unexpected error occoured.

See Also

IAPI