IFunctionInstanceCollection::Get method (functiondiscoveryapi.h)

  • Article

[Function Discovery is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Gets the specified function instance and its index from the collection.

Syntax

HRESULT Get(
  [in]  const WCHAR       *pszInstanceIdentity,
  [out] DWORD             *pdwIndex,
  [out] IFunctionInstance **ppIFunctionInstance
);

Parameters

[in] pszInstanceIdentity

The identifier of the function instance to be retrieved (see GetID).

[out] pdwIndex

The index number.

[out] ppIFunctionInstance

A pointer to an IFunctionInstance interface pointer that receives the function instance.

Return value

Possible return values include, but are not limited to, the following.

Return code Description
S_OK
 The method completed successfully.
S_FALSE
 The function instance identified by pInstanceIdentity is not present in the function instance collection.
E_INVALIDARG
 The value of pdwIndex or pInstanceIdentity is invalid.
E_OUTOFMEMORY
 The method is unable to allocate the memory required to perform this operation.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header functiondiscoveryapi.h
DLL FunDisc.dll

See also

IFunctionInstanceCollection