Metodo IBindCtx::SetBindOptions (objidl.h)
Imposta nuovi valori per i parametri di associazione archiviati nel contesto di associazione.
Sintassi
HRESULT SetBindOptions(
[in] BIND_OPTS *pbindopts
);
Parametri
[in] pbindopts
Puntatore a una struttura BIND_OPTS3 contenente i parametri di associazione.
Valore restituito
Questo metodo può restituire i valori restituiti standard E_OUTOFMEMORY e S_OK.
Commenti
Un contesto di associazione contiene un blocco di parametri comuni alla maggior parte delle operazioni IMoniker . Questi parametri non cambiano quando l'operazione passa da pezzo a pezzo di un moniker composito.
Le operazioni di associazione successive possono chiamare IBindCtx::GetBindOptions per recuperare questi parametri.
Note ai chiamanti
Questo metodo può essere chiamato dai client moniker (quelli che usano moniker per acquisire puntatori di interfaccia agli oggetti).Quando si crea prima un contesto di associazione usando la funzione CreateBindCtx , i campi della struttura di BIND_OPTS vengono inizializzati ai valori seguenti:
cbStruct = sizeof(BIND_OPTS);
grfFlags = 0;
grfMode = STGM_READWRITE;
dwTickCountDeadline = 0;
È possibile usare il metodo IBindCtx::SetBindOptions per modificare questi valori prima di usare il contesto di associazione, se si desiderano valori diversi dai valori predefiniti.
SetBindOptions copia i membri della struttura specificata, ma non la struttura COSERVERINFO e i puntatori contenuti. I chiamanti potrebbero non liberare questi puntatori finché non viene rilasciato il contesto di associazione.
Requisiti
Client minimo supportato | Windows 2000 Professional [app desktop | App UWP] |
Server minimo supportato | Windows 2000 Server [app desktop | App UWP] |
Piattaforma di destinazione | Windows |
Intestazione | objidl.h |