IBindCtx::SetBindOptions-Methode (objidl.h)
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 |