Функция OleUIChangeSourceA (oledlg.h)

Статья
11/20/2024

Вызывает диалоговое окно изменение источника, что позволяет пользователю изменить источник ссылки.

Синтаксис

UINT OleUIChangeSourceA(
  [in] LPOLEUICHANGESOURCEA unnamedParam1
);

Параметры

[in] unnamedParam1

Указатель на OLEUICHANGESOURCE структуру для этого диалогового окна.

Возвращаемое значение

Стандартные определения успешности и ошибок

Возвращаемый код	Описание
OLEUI_FALSE	Неизвестный сбой (неиспользуемый).
OLEUI_OK	Пользователь нажимал кнопку "ОК".
OLEUI_SUCCESS	Нет ошибок, аналогичных OLEUI_OK.
OLEUI_CANCEL	Пользователь нажимал кнопку "Отмена".

Ошибки проверки стандартных полей

Возвращаемый код	Описание
OLEUI_ERR_STANDARDMIN	Ошибки, распространенные для всех диалоговых окон, лежат в диапазоне OLEUI_ERR_STANDARDMIN OLEUI_ERR_STANDARDMAX. Это значение позволяет приложению тестировать стандартные сообщения для отображения сообщений об ошибках пользователю.
OLEUI_ERR_STRUCTURENULL	Указатель на структуру OLEUIXXX, переданную в функцию, был null.
OLEUI_ERR_STRUCTUREINVALID	Недостаточно разрешений для доступа на чтение или запись к структуре OLEUIXXX.
OLEUI_ERR_CBSTRUCTINCORRECT	Неверное значение cbstruct.
OLEUI_ERR_HWNDOWNERINVALID	Недопустимое значение hWndOwner.
OLEUI_ERR_LPSZCAPTIONINVALID	Значение lpszCaption недопустимо.
OLEUI_ERR_LPFNHOOKINVALID	Недопустимое значение lpfnHook.
OLEUI_ERR_HINSTANCEINVALID	Недопустимое значение hInstance.
OLEUI_ERR_LPSZTEMPLATEINVALID	Недопустимое значение lpszTemplate.
OLEUI_ERR_HRESOURCEINVALID	Недопустимое значение hResource.

Ошибки инициализации

Возвращаемый код	Описание
OLEUI_ERR_FINDTEMPLATEFAILURE	Не удалось найти шаблон диалогового окна.
OLEUI_ERR_LOADTEMPLATEFAILURE	Не удалось загрузить шаблон диалогового окна.
OLEUI_ERR_DIALOGFAILURE	Сбой инициализации диалогового окна.
OLEUI_ERR_LOCALMEMALLOC	Сбой вызова LocalAlloc или стандартного IMalloc распределителя.
OLEUI_ERR_GLOBALMEMALLOC	Сбой вызова GlobalAlloc или стандартного распределителя IMalloc.
OLEUI_ERR_LOADSTRING	Не удалось вызвать LoadString для локализованных ресурсов из библиотеки.
OLEUI_ERR_OLEMEMALLOC	Сбой вызова стандартного IMalloc распределителя.

Ошибки, связанные с конкретной функцией

Возвращаемый код	Описание
OLEUI_ERR_STANDARDMAX	Ошибки, распространенные для всех диалоговых окон, лежат в диапазоне OLEUI_ERR_STANDARDMIN OLEUI_ERR_STANDARDMAX. Это значение позволяет приложению тестировать стандартные сообщения для отображения сообщений об ошибках пользователю.
OLEUI_CSERR_LINKCNTRNULL	Значение lpOleUILinkContainer равно NULL.
OLEUI_CSERR_LINKCNTRINVALID	Значение lpOleUILinkContainer недопустимо.
OLEUI_CSERR_FROMNOTNULL	Значение lpszFrom не NULL.
OLEUI_CSERR_TONOTNULL	Значение lpszTo не NULL.
OLEUI_CSERR_SOURCEINVALID	Значение lpszDisplayName или nFileLength недопустимо или не может получить источник ссылки.
OLEUI_CSERR_SOURCEPARSEERROR	Значение nFilename неправильно.

Замечания

Источник ссылки не изменяется в диалоговом окне "Изменить источник". Вместо этого вызывающий объект изменяет источник ссылки с помощью возвращаемых строк файла и элементов. Диалоговое окно Изменение ссылок обычно делает это для вызывающего объекта.

Заметка

Заголовок oledlg.h определяет OLEUICHANGESOURCE как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	oledlg.h
библиотеки	OleDlg.lib
DLL	OleDlg.dll

См. также

IOleUILinkContainer

OLEUICHANGESOURCE

OleUIEditLinks

Поделиться через