IFunctionInstance::OpenPropertyStore-Methode (functiondiscoveryapi.h)

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

Öffnet den Eigenschaftenspeicher für die Funktion instance. Der Eigenschaftenspeicher enthält Metadaten zur Funktion instance, z. B. Name, Symbol, Installationsdatum und andere Informationen.

Syntax

HRESULT OpenPropertyStore(
  [in]  DWORD          dwStgAccess,
  [out] IPropertyStore **ppIPropertyStore
);

Parameter

[in] dwStgAccess

Der Zugriffsmodus, der dem geöffneten Stream zugewiesen werden soll. Für diese Methode werden die folgenden Zugriffsmodi unterstützt:

STGM_READ

STGM_READWRITE

STGM_WRITE

[out] ppIPropertyStore

Ein Zeiger auf einen IPropertyStore-Schnittstellenzeiger .

Rückgabewert

Mögliche Rückgabewerte sind u. a. die folgenden:

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
STG_E_ACCESSDENIED	Die -Methode konnte keinen schreibbaren Eigenschaftenspeicher öffnen, weil der Aufrufer über unzureichenden Zugriff verfügt oder der Ermittlungsanbieter keinen Schreibzugriff auf seinen Eigenschaftenspeicher zulässt.
E_INVALIDARG	Der Wert von dwStgAccess ist ungültig.
E_POINTER	Der ppIPropertyStore verweist auf ungültigen Arbeitsspeicher.
E_OUTOFMEMORY	Die -Methode kann den für diesen Vorgang erforderlichen Arbeitsspeicher nicht zuordnen.

Hinweise

Pro Funktion kann jeweils nur ein Eigenschaftenspeicher geöffnet werden, instance. Wenn OpenPropertyStore für dieselbe Funktion instance zweimal aufgerufen wird, verweisen beide ppIPropertyStore-Zeiger auf denselben Eigenschaftenspeicher. Darüber hinaus wird der Zugriffsmodus (wie durch den dwStgAccess-Parameter angegeben) durch den letzten OpenPropertyStore-Aufruf bestimmt. Anwendungen sollten Release aufrufen, um einen Eigenschaftenspeicher zu schließen, bevor sie einen anderen öffnen.

Es ist möglich, dass OpenPropertyStore einen Eigenschaftenspeicher für ein Gerät zurückgibt, das entfernt wurde. In diesem Fall sind die Eigenschaftenschlüssel im Speicher leer. Diese Situation kann auftreten, wenn der Devnode des Geräts gelöscht wurde, aber der Eigenschaftenspeicher, der der Funktion des Geräts zugeordnet ist, instance weiterhin zugänglich ist. Diese Situation tritt selten auf.

Anforderungen

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

Weitere Informationen

IFunctionInstance