RegisterAppStateChangeNotification-Funktion (appnotify.h)

Ermöglicht es einer App, eine Rückruffunktion zu registrieren, über die sie benachrichtigt werden kann, dass ihre Bibliothek in einen angehaltenen Zustand wechselt oder aus ihm herauskommt. Die App kann diese Informationen verwenden, um alle erforderlichen Vorgänge auszuführen, z. B. zum Beibehalten des Zustands, die an diesem Punkt ausgeführt werden sollen.

Syntax

APICONTRACT ULONG RegisterAppStateChangeNotification(
  [in]           PAPPSTATE_CHANGE_ROUTINE Routine,
  [in, optional] PVOID                    Context,
  [out]          PAPPSTATE_REGISTRATION   *Registration
);

Parameter

[in] Routine

Ein Zeiger auf eine Rückruffunktion, die aufgerufen wird, wenn die App in den angehaltenen Zustand wechselt oder diesen verlässt. Weitere Informationen zu dieser Funktion finden Sie unter PAPPSTATE_CHANGE_ROUTINE .

[in, optional] Context

App-spezifische Kontextinformationen, die die App verwendet, wenn sie in einen angehaltenen Zustand wechselt oder aus dem Zustand angehalten wird. Dies ist in der Regel ein "this"-Zeiger.

[out] Registration

Wenn diese Funktion erfolgreich zurückgegeben wird, empfängt dieser Parameter die Adresse eines Zeigers auf einen Wert, der zum Identifizieren der Registrierung verwendet werden kann. Speichern Sie diesen Wert für die Verwendung mit UnregisterAppStateChangeNotification.

Rückgabewert

Ein Standardmäßiger Win32-status-Code.

Anforderungen

Weitere Informationen

UnregisterAppStateChangeNotification