Skip to content

Latest commit

 

History

History
138 lines (103 loc) · 5.89 KB

nf-functiondiscoveryprovider-ifunctiondiscoveryprovider-initialize.md

File metadata and controls

138 lines (103 loc) · 5.89 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:functiondiscoveryprovider.IFunctionDiscoveryProvider.Initialize
IFunctionDiscoveryProvider::Initialize (functiondiscoveryprovider.h)
Initializes the Function Discovery provider object.
IFunctionDiscoveryProvider interface
Initialize method
IFunctionDiscoveryProvider.Initialize
IFunctionDiscoveryProvider::Initialize
Initialize
Initialize method
Initialize method
IFunctionDiscoveryProvider interface
STGM_READ
STGM_READWRITE
STGM_WRITE
functiondiscoveryprovider/IFunctionDiscoveryProvider::Initialize
ncd.ifunctiondiscoveryprovider_initialize_method
ncd\ifunctiondiscoveryprovider_initialize_method.htm
ncd
084d6d91-4637-4325-887b-e9f46ecaaee4
12/05/2018
IFunctionDiscoveryProvider interface,Initialize method, IFunctionDiscoveryProvider.Initialize, IFunctionDiscoveryProvider::Initialize, Initialize, Initialize method, Initialize method,IFunctionDiscoveryProvider interface, STGM_READ, STGM_READWRITE, STGM_WRITE, functiondiscoveryprovider/IFunctionDiscoveryProvider::Initialize, ncd.ifunctiondiscoveryprovider_initialize_method
functiondiscoveryprovider.h
Windows
Windows Vista [desktop apps only]
Windows Server 2008 [desktop apps only]
FunctionDiscoveryProvider.idl
Windows
19H1
IFunctionDiscoveryProvider::Initialize
functiondiscoveryprovider/IFunctionDiscoveryProvider::Initialize
c++
APIRef
kbSyntax
COM
FunctionDiscoveryProvider.h
IFunctionDiscoveryProvider.Initialize

IFunctionDiscoveryProvider::Initialize

-description

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

Initializes the Function Discovery provider object. This method is intended to be called immediately after the object is created.

-parameters

-param pIFunctionDiscoveryProviderFactory [in]

A pointer to the IFunctionDiscoveryProviderFactory interface. The provider should use this interface to create new Function Discovery objects.

-param pIFunctionDiscoveryNotification [in]

A pointer to an IFunctionDiscoveryNotification interface. The provider should use this interface to send OnUpdate, OnEvent, and OnError notifications to the Function Discovery notification queue. Queued notifications are sent to client programs by Function Discovery.

-param lcidUserDefault [in]

The locale identifier of the caller. The provider should use lcidUserDefault to return localized strings for the resource enumerated by the provider.

-param pdwStgAccessCapabilities [out]

Specifies the least restrictive possible access mode of the property stores associated with the function instances created by this provider.

If the DWORD value is set to -1, InstancePropertyStoreValidateAccess will be called every time OpenPropertyStore is called on a function instance created by this provider. Otherwise, the value specified by this parameter determines the least restrictive possible access mode for all property stores associated with all function instances created by this provider. A more restrictive access mode will be applied to an individual property store if a client calls OpenPropertyStore with the dwStgAccess parameter set to a value that is more restrictive than the specified pdwStgAccessCapabilities value.

For efficiency, specify a pdwStgAccessCapabilities value whenever possible.

The following modes are supported:

STGM_READ

STGM_READWRITE

STGM_WRITE

-returns

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

Return code Description
S_OK
The method completed successfully.
E_INVALIDARG
One of the parameters contains an invalid argument.

-remarks

If your provider is going to create Function Discovery objects, queue notifications, or enumerate resources with localized strings, you must call AddRef on and cache the initialized pIFunctionDiscoveryProviderFactory, pIFunctionDiscoveryNotification, and lcidUserDefault parameters for later use when you implement the Initialize method.

-see-also

IFunctionDiscoveryProvider