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

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

  • Статья

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

Синтаксис

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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header oledlg.h
Библиотека OleDlg.lib
DLL OleDlg.dll

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

IOleUILinkContainer

OLEUICHANGESOURCE

OleUIEditLinks