IMMDevice::OpenPropertyStore-Methode (mmdeviceapi.h)
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 |
|---|---|
|
Parameter stgmAccess ist kein gültiger Zugriffsmodus. |
|
Der Parameter ppProperties ist NULL. |
|
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 |