COleChangeSourceDialog::DoModal

Call this function to display the OLE Change Source dialog box.

virtual INT_PTR DoModal( );

Return Value

Completion status for the dialog box. One of the following values:

• IDOK if the dialog box was successfully displayed.

• IDCANCEL if the user canceled the dialog box.

• IDABORT if an error occurred. If IDABORT is returned, call the COleDialog::GetLastError member function to get more information about the type of error that occurred. For a listing of possible errors, see the OleUIChangeSource function in Windows SDK.

Remarks

If you want to initialize the various dialog box controls by setting members of the m_cs structure, you should do this before calling DoModal, but after the dialog object is constructed.

If DoModal returns IDOK, you can call member functions to retrieve user-entered settings or information from the dialog box. The following list names typical query functions:

• GetFileName

• GetDisplayName

• GetItemName

Requirements

Header: afxodlgs.h

See Also

Reference

COleChangeSourceDialog Class

Hierarchy Chart

COleChangeSourceDialog::COleChangeSourceDialog

Other Resources

COleChangeSourceDialog Members