IDirectInputJoyConfig8::OpenAppStatusKey-Methode (dinputd.h)

Die IDirectInputJoyConfig8::OpenAppStatusKey-Methode öffnet den Stammschlüssel der Anwendung status Registrierungsschlüssel und ruft ein Handle für den Schlüssel als Rückgabeparameter ab.

Syntax

HRESULT OpenAppStatusKey(
  PHKEY unnamedParam1
);

Parameter

unnamedParam1

Verweist auf die Adresse einer Variablen (vom Typ HKEY), die ein Registrierungsschlüsselhandle enthält, wenn die Methode erfolgreich ist. Weitere Nutzungsdetails finden Sie unter Hinweise.

Rückgabewert

Gibt bei erfolgreicher Ausführung DI_OK zurück. Gibt andernfalls einen der folgenden COM-Fehlerwerte zurück. Die folgenden Fehlercodes sollen veranschaulichend und nicht unbedingt umfassend sein.

Rückgabecode Beschreibung
DIERR_INVALIDPARAM
Mindestens ein Parameter war ungültig.
DIERR_NOTFOUND
Der Schlüssel fehlt auf diesem System. Anwendungen sollten so fortgesetzt werden, als ob der Schlüssel leer wäre.

Hinweise

Das im parameter phKey zurückgegebene Registrierungsschlüsselhandle kann mit den Win32-Standardregistrierungsfunktionen verwendet werden. Die Dinputd.h-Headerdatei definiert die folgenden Zeichenfolgenkonstanten für den Zugriff auf Unterschlüssel und benannte Werte, die in der Anwendung status Stammschlüssel enthalten sind.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile dinputd.h (include Dinputd.h)