IWMDMOperation ::End, méthode (mswmdm.h)

La méthode End indique qu’une opération de lecture ou d’écriture est terminée, qu’elle réussisse ou non, et qu’elle retourne un code d’achèvement.

Syntaxe

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

Paramètres

[in] phCompletionCode

Code d’achèvement de l’opération.

[in] pNewObject

Lors de l’envoi à un appareil, pointeur vers un nouvel objet IWMDMStorage représentant le nouvel objet qui a été envoyé à l’appareil. Lors de la lecture à partir d’un appareil, pointeur vers l’objet IWMDMStorage qui a été lu à partir de l’appareil.

Valeur retournée

Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes suivantes de codes d’erreur :

• Codes d’erreur COM standard
• Codes d’erreur Windows convertis en valeurs HRESULT
• Codes d’erreur Gestionnaire de périphériques Windows Media

Remarques

La méthode End est appelée si le transfert a réussi ou non, et est la dernière méthode IWMDMOperation appelée. Cette méthode peut être utilisée pour signaler à l’application qu’elle ferme tous les handles de fichiers et autres objets requis par l’opération de lecture ou d’écriture.

Exemples

Le code C++ suivant ferme un handle de fichier global après une action de lecture ou d’écriture et génère un message.

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

Configuration requise

Voir aussi

Gestion manuelle des transferts de fichiers

IWMDMOperation, interface