IWMDMOperation::End-Methode (mswmdm.h)

Die End-Methode gibt an, dass ein Lese- oder Schreibvorgang abgeschlossen ist, unabhängig davon, ob er erfolgreich war oder nicht, und gibt einen Vervollständigungscode zurück.

Syntax

HRESULT End(
  [in] HRESULT  *phCompletionCode,
  [in] IUnknown *pNewObject
);

Parameter

[in] phCompletionCode

Vervollständigungscode für den Vorgang.

[in] pNewObject

Beim Senden an ein Gerät wird ein Zeiger auf ein neues IWMMMStorage-Objekt angezeigt, das das neue Objekt darstellt, das an das Gerät gesendet wurde. Beim Lesen von einem Gerät ein Zeiger auf das IWMDMStorage-Objekt , das vom Gerät gelesen wurde.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

• Com-Standardfehlercodes
• In HRESULT-Werte konvertierte Windows-Fehlercodes
• Windows Media Geräte-Manager Fehlercodes

Eine ausführliche Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Die End-Methode wird aufgerufen, unabhängig davon, ob die Übertragung erfolgreich war, und ist die letzte aufgerufene IWMDMOperation-Methode . Diese Methode kann verwendet werden, um der Anwendung zu signalisieren, alle Dateihandles und andere Objekte zu schließen, die für den Lese- oder Schreibvorgang erforderlich sind.

Beispiele

Der folgende C++-Code schließt ein globales Dateihandle nach einer Lese- oder Schreibaktion und gibt eine Nachricht aus.

HRESULT End(HRESULT* phCompletionCode, IUnknown* pNewObject)
{
    // TODO: Display the message: "IWMDMOperation event--End."

    // Close the file handle now that we're done with it.
    if (m_File != INVALID_HANDLE_VALUE)
        if (!CloseHandle(m_File))
            // TODO: Display the message: "Couldn't close the file."

    // Reset global status flag.
    m_OperationStatus = OPERATION_UNINITIALIZED;
    return S_OK;
}

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	mswmdm.h
Bibliothek	Mssachlp.lib

Weitere Informationen

Manuelles Behandeln von Dateiübertragungen

IWMDMOperation-Schnittstelle