Método IBindCtx::SetBindOptions (objidl.h)

Establece nuevos valores para los parámetros de enlace almacenados en el contexto de enlace.

Sintaxis

HRESULT SetBindOptions(
  [in] BIND_OPTS *pbindopts
);

Parámetros

[in] pbindopts

Puntero a una estructura de BIND_OPTS3 que contiene los parámetros de enlace.

Valor devuelto

Este método puede devolver los valores devueltos estándar E_OUTOFMEMORY y S_OK.

Comentarios

Un contexto de enlace contiene un bloque de parámetros que son comunes a la mayoría de las operaciones de IMoniker . Estos parámetros no cambian a medida que la operación pasa de pieza a pieza de un moniker compuesto.

Las operaciones de enlace posteriores pueden llamar a IBindCtx::GetBindOptions para recuperar estos parámetros.

Notas a los autores de llamadas

Los clientes de moniker pueden llamar a este método (aquellos que usan monikers para adquirir punteros de interfaz a objetos).

Al crear por primera vez un contexto de enlace mediante la función CreateBindCtx , los campos de la estructura BIND_OPTS se inicializan en los valores siguientes:

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

Puede usar el método IBindCtx::SetBindOptions para modificar estos valores antes de usar el contexto de enlace, si desea valores distintos de los predeterminados.

SetBindOptions copia los miembros de la estructura especificada, pero no la estructura COSERVERINFO y los punteros que contiene. Es posible que los autores de llamadas no liberen estos punteros hasta que se libere el contexto de enlace.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado objidl.h

Consulte también

BIND_OPTS

BIND_OPTS2

BIND_OPTS3

IBindCtx