ITcModuleManager2::TryLookupModule

Initialize pipModules with NULL and pbFound with VARIANT_FALSE, then search for all module instances with matching module type names. If matches are found, an ITcEnumModuleInstances enumerator is returned over the found ITcModuleInstance2 objects, and pbFound is set to VARIANT_TRUE.

Signature

HRESULT TryLookupModule(BSTR bstrModuleType, ITcEnumModuleInstances** pipModules, VARIANT_BOOL* pbFound);

Parameter

Name	Type	Description
bstrModuleType	BSTR	[in] Sought-after module type name.

Return value

Name	Type	Description
pipModules	ITcEnumModuleInstances**	[out] Enumerator of the found module instances or `NULL`.
pbFound	VARIANT_BOOL*	[out, retval] `VARIANT_TRUE` if at least one instance was found.
(HRESULT)	HRESULT	`S_OK` if successful, otherwise an error code.

Error codes

E_POINTER: pipModules, pbFound, or bstrModuleType is NULL.
E_INVALIDARG: The type name is empty.
E_OUTOFMEMORY: The temporary results array could not be created.
Other errors: QueryInterface or ModuleTypeName failed for a module instance.