Metodo IWMDMOperation::End (mswmdm.h)
Il metodo End indica che un'operazione di lettura o scrittura è stata completata, se ha esito positivo o negativo e restituisce un codice di completamento.
Sintassi
HRESULT End(
[in] HRESULT *phCompletionCode,
[in] IUnknown *pNewObject
);
Parametri
[in] phCompletionCode
Codice di completamento per l'operazione.
[in] pNewObject
Quando si invia a un dispositivo, un puntatore a un nuovo oggetto IWMDMStorage che rappresenta il nuovo oggetto inviato al dispositivo. Durante la lettura da un dispositivo, un puntatore all'oggetto IWMDMStorage letto dal dispositivo.
Valore restituito
Il metodo restituisce un valore HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:
- Codici di errore COM standard
- Codici di errore di Windows convertiti in valori HRESULT
- Codici di errore di Windows Media Gestione dispositivi
Commenti
Il metodo End viene chiamato indipendentemente dal fatto che il trasferimento sia riuscito e sia l'ultimo metodo IWMDMOperation chiamato. Questo metodo può essere usato per segnalare all'applicazione di chiudere tutti gli handle di file e altri oggetti richiesti dall'operazione di lettura o scrittura.
Esempio
Il codice C++ seguente chiude un handle di file globale dopo un'azione di lettura o scrittura e restituisce un messaggio.
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;
}
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | mswmdm.h |
| Libreria | Mssachlp.lib |