Metodo IFunctionDiscoveryProvider::Initialize (functiondiscoveryprovider.h)

[L'individuazione delle funzioni è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

Inizializza l'oggetto provider di individuazione funzioni. Questo metodo deve essere chiamato immediatamente dopo la creazione dell'oggetto.

Sintassi

HRESULT Initialize(
  [in]  IFunctionDiscoveryProviderFactory *pIFunctionDiscoveryProviderFactory,
  [in]  IFunctionDiscoveryNotification    *pIFunctionDiscoveryNotification,
  [in]  LCID                              lcidUserDefault,
  [out] DWORD                             *pdwStgAccessCapabilities
);

Parametri

[in] pIFunctionDiscoveryProviderFactory

Puntatore all'interfaccia IFunctionDiscoveryProviderFactory . Il provider deve usare questa interfaccia per creare nuovi oggetti individuazione funzioni.

[in] pIFunctionDiscoveryNotification

Puntatore a un'interfaccia IFunctionDiscoveryNotification . Il provider deve usare questa interfaccia per inviare notifiche OnUpdate, OnEvent e OnError alla coda di notifica di Individuazione funzioni. Le notifiche in coda vengono inviate ai programmi client dall'individuazione delle funzioni.

[in] lcidUserDefault

Identificatore delle impostazioni locali del chiamante. Il provider deve usare lcidUserDefault per restituire stringhe localizzate per la risorsa enumerata dal provider.

[out] pdwStgAccessCapabilities

Specifica la modalità di accesso meno restrittiva possibile degli archivi di proprietà associati alle istanze di funzione create da questo provider.

Se il valore DWORD è impostato su -1, InstancePropertyStoreValidateAccess verrà chiamato ogni volta che OpenPropertyStore viene chiamato in un'istanza di funzione creata da questo provider. In caso contrario, il valore specificato da questo parametro determina la modalità di accesso meno restrittiva possibile per tutti gli archivi di proprietà associati a tutte le istanze di funzione create da questo provider. Una modalità di accesso più restrittiva verrà applicata a un singolo archivio proprietà se un client chiama OpenPropertyStore con il parametro dwStgAccess impostato su un valore più restrittivo rispetto al valore pdwStgAccessCapabilities specificato.

Per l'efficienza, specificare un valore pdwStgAccessCapabilities quando possibile.

Sono supportate le modalità seguenti:

STGM_READ

STGM_READWRITE

STGM_WRITE

Valore restituito

I valori restituiti possibili includono, ma non sono limitati ai valori seguenti.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
E_INVALIDARG	Uno dei parametri contiene un argomento non valido.

Commenti

Se il provider creerà oggetti di individuazione delle funzioni, notifiche di coda o enumererà risorse con stringhe localizzate, è necessario chiamare AddRef in e memorizzare nella cache i parametri inizializzati pIFunctionDiscoveryProviderFactory, pIFunctionDiscoveryNotification e lcidUserDefault per usarli successivamente quando si implementa il metodo Initialize .

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	functiondiscoveryprovider.h

Vedi anche

IFunctionDiscoveryProvider