IMMDevice::OpenPropertyStore-Methode (mmdeviceapi.h)

  • Artikel

Die OpenPropertyStore-Methode ruft eine Schnittstelle zum Eigenschaftenspeicher des Geräts ab.

Syntax

HRESULT OpenPropertyStore(
  [in]  DWORD          stgmAccess,
  [out] IPropertyStore **ppProperties
);

Parameter

[in] stgmAccess

Der Speicherzugriffsmodus. Dieser Parameter gibt an, ob der Eigenschaftenspeicher im Lesemodus, im Schreibmodus oder im Lese-/Schreibmodus geöffnet werden soll. Legen Sie diesen Parameter auf eine der folgenden STGM-Konstanten fest:

STGM_READ

STGM_WRITE

STGM_READWRITE

Die -Methode ermöglicht es einem Client, der als Administrator ausgeführt wird, einen Speicher für schreibgeschützten, schreibgeschützten oder Lese-/Schreibzugriff zu öffnen. Ein Client, der nicht als Administrator ausgeführt wird, ist auf schreibgeschützten Zugriff beschränkt. Weitere Informationen zu STGM-Konstanten finden Sie in der Windows SDK-Dokumentation.

[out] ppProperties

Zeiger auf eine Zeigervariable, in die die -Methode die Adresse der IPropertyStore-Schnittstelle des Geräteeigenschaftenspeichers schreibt. Mit dieser Methode erhält der Aufrufer einen gezählten Verweis auf die Schnittstelle. Der Aufrufer ist für das Freigeben der Schnittstelle verantwortlich, wenn sie nicht mehr benötigt wird, indem die Release-Methode der Schnittstelle aufgerufen wird. Wenn beim OpenPropertyStore-Aufruf ein Fehler auftritt, ist *ppPropertiesNULL. Weitere Informationen zu IPropertyStore finden Sie in der Dokumentation zum Windows SDK.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.

Rückgabecode Beschreibung
E_INVALIDARG
 Parameter stgmAccess ist kein gültiger Zugriffsmodus.
E_POINTER
 Der Parameter ppProperties ist NULL.
E_OUTOFMEMORY
 Nicht genügend Arbeitsspeicher.

Hinweise

Im Allgemeinen sind die Eigenschaften im Eigenschaftenspeicher des Geräts schreibgeschützt für Clients, die keine Verwaltungs-, System- oder Dienstfunktionen ausführen.

Codebeispiele, die die OpenPropertyStore-Methode aufrufen, finden Sie in den folgenden Themen:

Anforderungen

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

Weitere Informationen

IMMDevice-Schnittstelle