IPXV_Inst::ShowCreateFileErrDlg Method
From PDF XChange PDF SDK
m (Automatic page editing by robot) |
m (Automatic page editing by robot) |
||
(6 intermediate revisions by one other user not shown) | |||
Line 3: | Line 3: | ||
{{#customTitle:IPXV_Inst::ShowCreateFileErrDlg Method}} | {{#customTitle:IPXV_Inst::ShowCreateFileErrDlg Method}} | ||
{{#parentPage:PXV:IPXV_Inst#Methods|ShowCreateFileErrDlg|method}} | {{#parentPage:PXV:IPXV_Inst#Methods|ShowCreateFileErrDlg|method}} | ||
− | |||
{{ToReview}} | {{ToReview}} | ||
− | The method of | + | 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 == | == Syntax == | ||
Line 13: | Line 12: | ||
[in, defaultvalue(0)] HANDLE_T hWndParent, | [in, defaultvalue(0)] HANDLE_T hWndParent, | ||
[in, defaultvalue(0)] LONG nFlags, | [in, defaultvalue(0)] LONG nFlags, | ||
− | [out, defaultvalue(NULL)] IAFS_Name** | + | [out, defaultvalue(NULL)] IAFS_Name** pNewFileName, |
[out, retval] LONG* pRes);</pre> | [out, retval] LONG* pRes);</pre> | ||
== Parameters == | == Parameters == | ||
;pFileName | ;pFileName | ||
− | : Pointer to [[PXV:IAFS_Name|IAFS_Name]]. | + | : Pointer to [[PXV:IAFS_Name|IAFS_Name]] object that represents the problematic path. |
;hErr | ;hErr | ||
− | : | + | : Indicates the file-creation error. |
;hWndParent | ;hWndParent | ||
− | :[in, defaultvalue(0)] | + | :[in, defaultvalue(0)] The optional parameter that specifies the handle of parent window. |
;nFlags | ;nFlags | ||
− | :[in, defaultvalue(0)] | + | :[in, defaultvalue(0)] The optional value. See [[PXV:PXV_CreateFileErrDlgFlags|PXV_CreateFileErrDlgFlags]]. |
− | ; | + | ;pNewFileName |
− | :[out, defaultvalue(NULL)] | + | :[out, defaultvalue(NULL)] When user chooses the ''Save As'' option it may return the pointer to other [[PXV:IAFS_Name|IAFS_Name]] object. |
;pRes | ;pRes | ||
− | :[out, retval] | + | :[out, retval] Returns identifier of user choice. Possible values: |
+ | ::<tt>UIX_No</tt> | ||
+ | ::<tt>UIX_Retry</tt> | ||
+ | ::<tt>UIX_Cancel</tt> | ||
+ | ::that are from [[PXV:UIX_MsgBoxResult|UIX_MsgBoxResult]] enumeration. | ||
== Return Value == | == Return Value == |
Latest revision as of 02:57, 15 June 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** 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.