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


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

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

Синтаксис

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

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

BIND_OPTS

BIND_OPTS2

BIND_OPTS3

IBindCtx