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

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

  • Статья

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

Синтаксис

UINT OleUIChangeSourceW(
  [in] LPOLEUICHANGESOURCEW 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 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header oledlg.h
Библиотека OleDlg.lib
DLL OleDlg.dll

См. также раздел

IOleUILinkContainer

OLEUICHANGESOURCE

OleUIEditLinks