Metodo IBindCtx::SetBindOptions (objidl.h)

Articolo
08/25/2023

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