IAgentTransportShutdownCallback

Aktualisiert: November 2007

Definiert die Methoden, die von einem Rückrufobjekt für das Herunterfahren implementiert werden müssen.

IAgentTransportShutdownCallback : public IUnknown

Methoden

Methode	Beschreibung
IAgentTransportShutdownCallback::Shutdown	Ermöglicht es geräteseitigen Agents, einen Bereinigungs- und Beendigungsvorgang auszuführen.

Hinweise

Ein Geräte-Agent ist hilfreich, solange conmanclient2.exe auf dem Gerät ausgeführt wird. Wenn conmanclient2.exe heruntergefahren wird, werden sämtliche Geräte-Agents ebenfalls heruntergefahren. Ein Geräte-Agent kann eine Benachrichtigung zum Herunterfahren anfordern, um das Bereinigen und Beenden ordnungsgemäß auszuführen. Um eine Benachrichtigung zum Herunterfahren zu erhalten, muss der Geräte-Agent eine Klasse definieren, durch die diese Schnittstelle implementiert wird, und diese dann mithilfe von IDeviceAgentTransport::RegisterShutdownCallback registrieren.

Beispiel

Im folgenden Beispiel wird eine benutzerdefinierte Implementierung dieser Schnittstelle definiert. Das vollständige Beispiel finden Sie unter IDeviceAgentTransport.

// Custom implementation of IAgentTransportShutdownCallback
class MyShutdownCallback: public IAgentTransportShutdownCallback
{
private:
    long ref;
public:
    HRESULT STDMETHODCALLTYPE Shutdown(IUnknown *in_pUnknown) 
    {
        // Add your cleanup code here 
        MessageBox(NULL,_T("conmanclient2 exited"),_T("conmanclient exited"),0);
        return 0;
    }

    // Must implement members from IUnknown
    HRESULT STDMETHODCALLTYPE QueryInterface( REFIID riid, void __RPC_FAR *__RPC_FAR *ppvObject)
    {
        return 0;
    }
    ULONG STDMETHODCALLTYPE AddRef( void)
    {
        return InterlockedIncrement(&ref);
    }

    ULONG STDMETHODCALLTYPE Release( void)
    {
        if(InterlockedDecrement(&ref) == 0)
        {
            delete this;
            return 0;
        }
        return ref;
    }
};

Verwaltete Entsprechung

Microsoft.SmartDevice.DeviceAgentTransport.IAgentTransportShutdownCallback

Anforderungen

DeviceAgentTransport.h

Siehe auch

Weitere Ressourcen

Nicht verwaltete geräteseitige Device Connectivity-API für intelligente Geräte