|
OleUIChangeSource
Invokes the Change Source dialog box, allowing the user to change the source
of a link.
UINT OleUIChangeSource(
LPOLEUICHANGESOURCE lpCS
| //Points to the in-out structure
| );
|
|
Parameter
lpCS
Points to the in-out structure for this dialog.
Return Values
Standard Success/Error Definitions
OLEUI_FALSE
Unknown failure (unused).
OLEUI_SUCCESS
No error, same as OLEUI_OK.
OLEUI_OK
The user pressed the OK button.
OLEUI_CANCEL
The user pressed the Cancel button.
Standard Field Validation Errors
OLEUI_ERR_STANDARDMIN
Errors common to all dialogs lie in the range OLEUI_ERR_STANDARDMIN to
OLEUI_ERR_STANDARDMAX. This value allows the application to test for standard messages
in order to display error messages to the user.
OLEUI_ERR_STRUCTURENULL
The pointer to an OLEUIXXX structure passed into the function was NULL.
OLEUI_ERR_STRUCTUREINVALID
Insufficient permissions for read or write access to an OLEUIXXX structure.
OLEUI_ERR_CBSTRUCTINCORRECT
The cbstruct value is incorrect.
OLEUI_ERR_HWNDOWNERINVALID
The hWndOwner value is invalid.
OLEUI_ERR_LPSZCAPTIONINVALID
The lpszCaption value is invalid.
OLEUI_ERR_LPFNHOOKINVALID
The lpfnHook value is invalid.
OLEUI_ERR_HINSTANCEINVALID
The hInstance value is invalid.
OLEUI_ERR_LPSZTEMPLATEINVALID
The lpszTemplate value is invalid.
OLEUI_ERR_HRESOURCEINVALID
The hResource value is invalid.
Initialization Errors
OLEUI_ERR_FINDTEMPLATEFAILURE
Unable to find the dialog template.
OLEUI_ERR_LOADTEMPLATEFAILURE
Unable to load the dialog template.
OLEUI_ERR_DIALOGFAILURE
Dialog initialization failed.
OLEUI_ERR_LOCALMEMALLOC
A call to LocalAlloc or the standard IMalloc allocator failed.
OLEUI_ERR_GLOBALMEMALLOC
A call to GlobalAlloc or the standard IMalloc allocator failed.
OLEUI_ERR_LOADSTRING
Unable to LoadString localized resources from the library.
OLEUI_ERR_OLEMEMALLOC
A call to the standard IMalloc allocator failed.
Function Specific Errors
OLEUI_ERR_STANDARDMAX
Errors common to all dialogs lie in the range OLEUI_ERR_STANDARDMIN to
OLEUI_ERR_STANDARDMAX. This value allows the application to test for standard messages
in order to display error messages to the user.
OLEUI_CSERR_LINKCNTRNULL
The lpOleUILinkContainer value is NULL.
OLEUI_CSERR_LINKCNTRINVALID
The lpOleUILinkContainer value is invalid.
OLEUI_CSERR_FROMNOTNULL
The lpszFrom value is not NULL.
OLEUI_CSERR_TONOTNULL
The lpszTo value is not NULL.
OLEUI_CSERR_SOURCEINVALID
The lpszDisplayName or nFileLength value is invalid, or cannot retrieve the link source.
OLEUI_CSERR_SOURCEPARSEERROR
The nFilename value is wrong.
Comments
The link source is not changed by the Change Source dialog itself. Instead, it
is up to the caller to change the link source using the returned file and item
strings. The Edit Links dialog typically does this for the caller.
See Also
OLEUICHANGESOURCE, OleUIEditLinks, IOleUILinkContainer
Related LinksSoftware for Delphi and C++ Builder developers Software for Visual Studio .NET developers Software for Visual Basic 6 developers Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps Win32 Programmer's Reference (win32.hlp) Win32 Multimedia Programmer's Reference (mmedia.hlp) Microsoft Windows Pen API Programmer's Reference (penapi.hlp) Microsoft Windows Sockets 2 Reference (sock2.hlp) Microsoft Windows Telephony API (TAPI) Programmer's Reference (sock2.hlp) Unix Manual Pages
|