IBindCtx::SetBindOptions-Methode (objidl.h)

Artikel
08/25/2023

Legt neue Werte für die bindungsparameter fest, die im Bindungskontext gespeichert sind.

Syntax

HRESULT SetBindOptions(
  [in] BIND_OPTS *pbindopts
);

Parameter

[in] pbindopts

Ein Zeiger auf eine BIND_OPTS3-Struktur , die die Bindungsparameter enthält.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_OUTOFMEMORY und S_OK zurückgeben.

Hinweise

Ein Bindungskontext enthält einen Block von Parametern, die bei den meisten IMoniker-Vorgängen verwendet werden. Diese Parameter ändern sich nicht, wenn der Vorgang von Stück zu Stück eines zusammengesetzten Monikers wechselt.

Nachfolgende Bindungsvorgänge können IBindCtx::GetBindOptions aufrufen, um diese Parameter abzurufen.

Hinweise für Anrufer

Diese Methode kann von Monikerclients aufgerufen werden (diejenigen, die Moniker verwenden, um Schnittstellenzeiger auf Objekte zu erhalten).

Wenn Sie zum ersten Mal mithilfe der CreateBindCtx-Funktion einen Bindungskontext erstellen, werden die Felder der BIND_OPTS-Struktur mit den folgenden Werten initialisiert:

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

Sie können die IBindCtx::SetBindOptions-Methode verwenden, um diese Werte zu ändern, bevor Sie den Bindungskontext verwenden, wenn Sie andere Werte als die Standardwerte verwenden möchten.

SetBindOptions kopiert die Member der angegebenen Struktur, aber nicht die COSERVERINFO-Struktur und die darin enthaltenen Zeiger. Aufrufer können diese Zeiger erst freigeben, wenn der Bindungskontext freigegeben wird.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	objidl.h

Weitere Informationen