Freigeben über


IConsolePowerSink-Schnittstelle (mmc.h)

Die IConsolePowerSink-Schnittstelle überwacht und reagiert auf Energieverwaltungsmeldungen.

Vererbung

Die IConsolePowerSink-Schnittstelle erbt von der IUnknown-Schnittstelle . IConsolePowerSink verfügt auch über diese Arten von Membern:

Methoden

Die IConsolePowerSink-Schnittstelle verfügt über diese Methoden.

 
IConsolePowerSink::OnPowerBroadcast

Die OnPowerBroadcast-Methode verarbeitet WM_POWERBROADCAST Benachrichtigungen im Zusammenhang mit der Energieverwaltung des Computers.

Hinweise

Um Energieverwaltungsbenachrichtigungen zu erhalten, muss Ihr Snap-In die AtlAdvise-Funktion verwenden, um Ihrer Implementierung der IConsolePowerSink-Schnittstelle eine instance der IConsolePowerSink-Schnittstelle zuzuordnen. Im folgenden Codebeispiel wird die Verwendung der AtlAdvise-Funktion veranschaulicht.

Beispiele

// Connect the IConsolePower and IConsolePowerSink interfaces.
// m_ipConsolePower is a pointer to an instance of 
// the IConsolePower interface.
// m_ipConsolePowerSink is a pointer to an instance of 
// the IConsolePowerSink interface.
// m_dwCookie is of type DWORD.
hr = AtlAdvise(m_ipConsolePower,
               m_ipConsolePowerSink,
               IID_IConsolePowerSink,
               &m_dwCookie);

Wenn Ihr Snap-In geschlossen wird oder keine Energieverwaltungsbenachrichtigungen mehr benötigt, rufen Sie die AtlUnadvise-Funktion auf, um die Verbindung zwischen den IConsolePower- und IConsolePowerSink-Schnittstellen zu beenden. Im folgenden Codebeispiel wird die Verwendung der AtlUnadvise-Funktion veranschaulicht.

// Terminate the connection established previously.
hr = AtlUnadvise(m_ipConsolePower,
                 IID_IConsolePowerSink,
                 m_dwCookie);

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile mmc.h

Weitere Informationen

IConsolePower