# OleUIChangeSource

Invokes the Change Source dialog box, allowing the user to change the source of a link.

UINT OleUIChangeSource(

LPOLEUICHANGESOURCE lpCS | //Pointer to the in-out structure
); |

Parameter

lpCS
  [in] Pointer to the in-out OLEUICHANGESOURCE structure for this dialog box.

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 dialog boxes 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 box template.
OLEUI_ERR_LOADTEMPLATEFAILURE
  Unable to load the dialog box template.
OLEUI_ERR_DIALOGFAILURE
  Dialog box 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 dialog boxes 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.

Remarks

The link source is not changed by the Change Source dialog box itself. Instead, it is up to the caller to change the link source using the returned file and item strings. The Edit Links dialog box typically does this for the caller.

See Also

OLEUICHANGESOURCE, OleUIEditLinks, IOleUILinkContainer