IPXV_Inst::ShowCreateFileErrDlg Method

Revision as of 15:35, 26 May 2015

The method displays for end-user the dialog with description of the specified file-creation error and with some advanced options like: Retry, Save As etc.

Syntax

HRESULT ShowCreateFileErrDlg(                           IAFS_Name*   pFileName,
                                                        HRESULT      hErr,
                             [in, defaultvalue(0)]      HANDLE_T     hWndParent,
                             [in, defaultvalue(0)]      LONG         nFlags,
                             [out, defaultvalue(NULL)]  IAFS_Name**  ppNewFileName,
                             [out, retval]              LONG*        pRes);

Parameters

pFileName

Pointer to IAFS_Name object that represents the problematic path.

hErr

Indicates the file-creation error.

hWndParent

[in, defaultvalue(0)] The optional parameter containing the handle of parent window.

nFlags

[in, defaultvalue(0)] The optional value. See PXV_CreateFileErrDlgFlags.

ppNewFileName

[out, defaultvalue(NULL)] When user chooses the Save As option it may return the pointer to other IAFS_Name object.

pRes

[out, retval] Returns identifier of user choice. Possible values:

UIX_No

UIX_Retry

UIX_Cancel

that are from UIX_MsgBoxResult enumeration.

Return Value

Returns S_OK if operation was successful or error code in other cases.

See Also

IPXV_Inst