IPXV_Inst::ShowCreateFileErrDlg Method

From PDF XChange PDF SDK
Jump to: navigation, search


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**  pNewFileName,
                             [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 that specifies the handle of parent window.
nFlags
[in, defaultvalue(0)] The optional value. See PXV_CreateFileErrDlgFlags.
pNewFileName
[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