Метод IBindCtx::SetBindOptions (objidl.h)

Статья
08/25/2023

Задает новые значения для параметров привязки, хранящихся в контексте привязки.

Синтаксис

HRESULT SetBindOptions(
  [in] BIND_OPTS *pbindopts
);

Параметры

[in] pbindopts

Указатель на структуру BIND_OPTS3 , содержащую параметры привязки.

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

Этот метод может возвращать стандартные возвращаемые значения E_OUTOFMEMORY и S_OK.

Контекст привязки содержит блок параметров, которые являются общими для большинства операций IMoniker . Эти параметры не изменяются, так как операция перемещается от части к части составного моникера.

Последующие операции привязки могут вызывать IBindCtx::GetBindOptions для получения этих параметров.

Примечания к вызывающим абонентам

Этот метод может вызываться клиентами моникеров (теми, кто использует моникеры для получения указателей интерфейса на объекты).

При создании контекста привязки с помощью функции CreateBindCtx поля структуры BIND_OPTS инициализируются следующими значениями:

    cbStruct = sizeof(BIND_OPTS); 
    grfFlags = 0; 
    grfMode = STGM_READWRITE; 
    dwTickCountDeadline = 0;

Чтобы изменить эти значения перед использованием контекста привязки, можно использовать метод IBindCtx::SetBindOptions , если вам нужны значения, отличные от значений по умолчанию.

SetBindOptions копирует элементы указанной структуры, но не структуру COSERVERINFO и содержащиеся в ней указатели. Вызывающие стороны не могут освобождать эти указатели, пока контекст привязки не будет освобожден.

Требования


Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	objidl.h