IFunctionDiscoveryProvider::InstancePropertyStoreValidateAccess-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.]

Überprüft, ob der Anbieter den angeforderten Zugriff unterstützt. Es wird aufgerufen, wenn OpenPropertyStore für eine Funktion aufgerufen wird, instance, um zu überprüfen, ob der Anbieter den zugriffsmodus unterstützt, der vom dwStgAccess-Parameter übergeben wird.

Diese Methode wird nur aufgerufen, wenn die Initialize-Methode eines Anbieters den PdwStgAccessCapabilities-Parameterwert von -1 zurückgibt.

Syntax

HRESULT InstancePropertyStoreValidateAccess(
  [in] IFunctionInstance *pIFunctionInstance,
  [in] INT_PTR           iProviderInstanceContext,
  [in] const DWORD       dwStgAccess
);

Parameter

[in] pIFunctionInstance

Ein Zeiger auf die IFunctionInstance-Schnittstelle .

[in] iProviderInstanceContext

Der der spezifischen Funktion zugeordnete Kontext instance.

[in] dwStgAccess

Der zu überprüfende Zugriffsmodus. Für diese Methode werden die folgenden Modi 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_NOTIMPL	Der Anbieter implementiert keinen instance-Eigenschaftenspeicher.
STG_E_ACCESSDENIED	Die Methode konnte keinen schreibbaren Eigenschaftenspeicher öffnen, da der Aufrufer über unzureichenden Zugriff verfügt, der Ermittlungsanbieter keinen Schreibzugriff auf seinen Eigenschaftenspeicher zulässt oder ein anderer Eigenschaftenspeicher bereits für diese Funktion instance geöffnet ist.
E_INVALIDARG	Der Wert von dwStgAccess ist ungültig.
E_OUTOFMEMORY	Die -Methode kann den für diesen Vorgang erforderlichen Arbeitsspeicher nicht zuordnen.

Hinweise

Die genaue Bedeutung des STG_E_ACCESSDENIED Rückgabewerts ist implementierungsspezifisch. Wenn Sie die InstancePropertyStoreValidateAccess-Methode implementieren, können Sie STG_E_ACCESSDENIED für jeden angegebenen dwStgAccess-Moduswert für jede angegebene Funktion instance zurückgeben.

Anforderungen

Anforderung	Wert
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