IWMDMProgress2::End2 method (mswmdm.h)

Article
02/22/2024

The End2 method extends IWMDMProgress::End by providing a completion status indicator.

Syntax

HRESULT End2(
  [in] HRESULT hrCompletionCode
);

Parameters

[in] hrCompletionCode

The return value of the operation that ended.

Return value

The return value from the method is ignored by Windows Media Device Manager.

Remarks

IWMDMProgress2 is a callback interface provided by the application to Windows Media Device Manager for a particular operation. End2 is called when that operation is completed. The hrCompletionCode parameter is the completion status of the operation that was in progress. For example, an application can provide an IWMDMProgress2 interface pointer to the Insert2 method. When the file transfer done by Insert2 is completed, End2 is called on the IWMDMProgress2 interface pointer with the completion status of the file transfer as the hrCompletion parameter.

IWMDMProgress3::End3 provides more information, and should be implemented instead of this method.

Examples

The following C++ code is a simple implementation of the Progress2 method.


HRESULT Progress(DWORD  dwTranspiredTicks)
{
    // TODO: Display the message: "IWMDMProgress::Progress called." 
    // followed by the dwTranspiredTicks value.
    return S_OK;
}

Requirements

Requirement	Value
Target Platform	Windows
Header	mswmdm.h
Library	Mssachlp.lib