IFunctionDiscoveryProvider::Initialize-Methode (functiondiscoveryprovider.h)

[Funktionsermittlung ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Initialisiert das Objekt des Funktionsermittlungsanbieters. Diese Methode soll unmittelbar nach der Erstellung des Objekts aufgerufen werden.

Syntax

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

Parameter

[in] pIFunctionDiscoveryProviderFactory

Ein Zeiger auf die IFunctionDiscoveryProviderFactory-Schnittstelle . Der Anbieter sollte diese Schnittstelle verwenden, um neue Funktionsermittlungsobjekte zu erstellen.

[in] pIFunctionDiscoveryNotification

Ein Zeiger auf eine IFunctionDiscoveryNotification-Schnittstelle . Der Anbieter sollte diese Schnittstelle verwenden, um OnUpdate-, OnEvent- und OnError-Benachrichtigungen an die Funktionsermittlungsbenachrichtigungswarteschlange zu senden. Benachrichtigungen in der Warteschlange werden per Funktionsermittlung an Clientprogramme gesendet.

[in] lcidUserDefault

Der Gebietsschemabezeichner des Aufrufers. Der Anbieter sollte lcidUserDefault verwenden, um lokalisierte Zeichenfolgen für die vom Anbieter aufgelistete Ressource zurückzugeben.

[out] pdwStgAccessCapabilities

Gibt den möglichst wenig einschränkenden Zugriffsmodus der Eigenschaftenspeicher an, die den funktionsinstanzen zugeordnet sind, die von diesem Anbieter erstellt wurden.

Wenn der DWORD-Wert auf -1 festgelegt ist, wird InstancePropertyStoreValidateAccess jedes Mal aufgerufen, wenn OpenPropertyStore für eine Funktion aufgerufen wird, instance von diesem Anbieter erstellt wurde. Andernfalls bestimmt der durch diesen Parameter angegebene Wert den möglichst wenig einschränkenden Zugriffsmodus für alle Eigenschaftenspeicher, die allen funktionsinstanzen zugeordnet sind, die von diesem Anbieter erstellt wurden. Ein restriktiverer Zugriffsmodus wird auf einen einzelnen Eigenschaftenspeicher angewendet, wenn ein Client OpenPropertyStore aufruft, wobei der dwStgAccess-Parameter auf einen Wert festgelegt ist, der restriktiver als der angegebene pdwStgAccessCapabilities-Wert ist.

Geben Sie zur Effizienz nach Möglichkeit einen pdwStgAccessCapabilities-Wert an.

Die folgenden Modi werden unterstützt:

STGM_READ

STGM_READWRITE

STGM_WRITE

Rückgabewert

Mögliche Rückgabewerte sind unter anderem folgendes:

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_INVALIDARG	Einer der Parameter enthält ein ungültiges Argument.

Hinweise

Wenn Ihr Anbieter Funktionsermittlungsobjekte, Warteschlangenbenachrichtigungen oder Ressourcen mit lokalisierten Zeichenfolgen aufzählt, müssen Sie AddRef aufrufen und die initialisierten Parameter pIFunctionDiscoveryProviderFactory, pIFunctionDiscoveryNotification und lcidUserDefault zur späteren Verwendung bei der Implementierung der Initialize-Methode zwischenspeichern.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	functiondiscoveryprovider.h

Weitere Informationen

IFunctionDiscoveryProvider