Presents a prompt user interface (UI) to the user.

Syntax

HRESULT Prompt(      
    HWND hwnd,
    ATTACHMENT_PROMPT prompt,
    ATTACHMENT_ACTION *paction
);

Parameters

hwnd

[in] A handle to the parent window.

prompt

[in] A member of the ATTACHMENT_PROMPT enumeration that indicates what type of prompt UI to display to the user.

paction

[out] A member of the ATTACHMENT_ACTION enumeration that indicates the action to be performed upon user confirmation.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

You must call IAttachmentExecute::SetFileName or IAttachmentExecute::SetLocalPath before calling IAttachmentExecute::Prompt.

IAttachmentExecute::Prompt can be called by the application to force UI presentation before the file has been copied to disk.