Share via

INetCfgClass::FindComponent method

  • Article

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

Target platform

 Desktop

Header

 Netcfgx.h (include Netcfgx.h)

See also

INetCfgComponent

 

 

Send comments about this topic to Microsoft