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
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 |