RoRegisterForApartmentShutdown-Funktion (roapi.h)

Registriert einen IApartmentShutdown-Rückruf , der aufgerufen wird, wenn das aktuelle Apartment heruntergefahren wird.

Syntax

HRESULT RoRegisterForApartmentShutdown(
  [in]  IApartmentShutdown                     *callbackObject,
  [out] UINT64                                 *apartmentIdentifier,
  [out] APARTMENT_SHUTDOWN_REGISTRATION_COOKIE *regCookie
);

Parameter

[in] callbackObject

Die von der Anwendung bereitgestellte IApartmentShutdown-Schnittstelle .

[out] apartmentIdentifier

Der Bezeichner für das aktuelle Apartment.

[out] regCookie

Ein Cookie, mit dem Sie die Registrierung des Rückrufs aufheben können.

Rückgabewert

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Um Benachrichtigungen zum Herunterfahren von Wohnungen zu erhalten, muss Ihre App den Handler für das Herunterfahren der Wohnung beim System registrieren, indem sie die RoRegisterForApartmentShutdown-Funktion aufruft .

Warnung  

 

Rufen Sie die RoRegisterForApartmentShutdown-Funktion nicht über den OnUninitialize-Rückruf auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	roapi.h
Bibliothek	RuntimeObject.lib
DLL	ComBase.dll

Weitere Informationen

IApartmentShutdown

RoUnregisterForApartmentShutdown