INetCfgClass::FindComponent method

The FindComponent method retrieves a network component that belongs to this network component class and matches the specified component identifier.

Syntax

HRESULT FindComponent(
  [in]            LPCWSTR          pszwComponentId,
  [out, optional] INetCfgComponent **ppComponent
);

Parameters

• pszwComponentId [in]
  Pointer to a constant null-terminated string of 16-bit Unicode characters containing the identifier of the component to find.

• ppComponent [out, optional]
  Pointer to a buffer that receives a pointer to the INetCfgComponent interface of the network component, and which matches the component identifier contained in pszwComponentId. This parameter is a NULL value if the component is not found.

Return value

Returns zero (S_OK) if successful, indicating that a component with the specified identifier was found, and returns S_FALSE if the component was not found. Otherwise, returns NETCFG_* codes that are defined in Netcfgx.h.

Requirements

See also

INetCfgComponent

Send comments about this topic to Microsoft