Estructura WABEXTDISPLAY (wabapi.h)

No debe usarse. Usado por la libreta de direcciones de Windows (WAB) para inicializar las implementaciones de IContextMenu Interface e IShellPropSheetExt Interface del usuario.

Sintaxis

typedef struct _WABEXTDISPLAY {
  ULONG       cbSize;
  LPWABOBJECT lpWABObject;
  LPADRBOOK   lpAdrBook;
  LPMAPIPROP  lpPropObj;
  BOOL        fReadOnly;
  BOOL        fDataChanged;
  ULONG       ulFlags;
  LPVOID      lpv;
  LPTSTR      lpsz;
} WABEXTDISPLAY, *LPWABEXTDISPLAY;

Miembros

cbSize

Tipo: ULONG

No se usa.

lpWABObject

Tipo: LPWABOBJECT

Puntero a una interfaz IWABObject que especifica el objeto que se va a usar para llamar a los métodos de asignación de memoria IWABObject . Estos métodos asignan cualquier memoria que devuelva al WAB y que espera que el WAB libere o use. También puede usar este puntero para llamar a cualquiera de los otros métodos IWABObject .

lpAdrBook

Tipo: LPADRBOOK

Puntero a una interfaz IAddrBook que especifica el objeto que se va a usar para llamar a cualquiera de los métodos IAddrBook de WAB estándar.

lpPropObj

Tipo: LPMAPIPROP

Puntero a un objeto IMailUser : IMAPIProp . Esta interfaz es relevante para las implementaciones de IShellPropSheetExt Interface e IContextMenu Interface . En el caso de las implementaciones de IShellPropSheetExt Interface, lpPropObj contiene el objeto real que se muestra. Puede ser un objeto IMailUser: IMAPIProp o IDistList: IMAPIContainer . Para determinar qué objeto lpPropObj es, consulte su propiedad PR_OBJECT_TYPE. Puede recuperar propiedades de este objeto para rellenar las hojas de propiedades de la extensión.

Para las implementaciones de IContextMenu Interface , lpPropObj contiene un objeto válido; sin embargo, este objeto no tiene ninguna propiedad asociada. Puede llamar a AddRef en este objeto para asegurarse de que el objeto y cualquier otro dato de interés en esta estructura WABEXTDISPLAY sobrevive mientras lo necesite. Si llama a AddRef, debe llamar a Release en lpPropObj cuando ya no lo necesite.

Si la aplicación usa propiedades con nombre y desea obtener las propiedades con nombre relevantes para usted desde wab, puede llamar al método GetIDsfromNames en este objeto lpPropObj para recuperar las propiedades con nombre. Si desea acceder a las propiedades asociadas a los usuarios de mensajería, convierta este objeto en un LPMAILUSER antes de llamar a GetIDsfromNames en él.

fReadOnly

Tipo: BOOL

Variable de tipo BOOL que especifica la propiedad de solo lectura en determinados tipos de objetos, como el atributo VCARD_NAME , los resultados de búsqueda LDAP y MailUser de un solo uso. Este miembro solo es relevante para la interfaz IShellPropSheetExt. Si esta marca se establece en true, la hoja de propiedades de uno debe establecer todos sus controles en un modo de solo lectura o deshabilitado, normalmente en respuesta al mensaje WM_INITDIALOG . Establecer controles en un estado de solo lectura hace que la experiencia del usuario sea más coherente.

fDataChanged

Tipo: BOOL

Variable de tipo BOOL que especifica la marca que indica que se ha realizado un cambio en la hoja de propiedades. Este miembro es relevante solo para la interfaz IShellPropSheetExt . Cada vez que el usuario realice un cambio, como agregar, editar o eliminar datos en la hoja de propiedades, debe establecer esta marca en true para indicar al WAB que los datos de la hoja de propiedades han cambiado. Si no se establece esta marca, es posible que WAB no conserve los cambios realizados por el usuario en la hoja de propiedades.

ulFlags

Tipo: ULONG

Variable de tipo ULONG que especifica marcas que controlan el comportamiento. Las marcas siguientes son válidas.

WAB_CONTEXT_ADRLIST

Establezca cuándo la WAB llama a Initialize antes de invocar los métodos IContextMenu Interface . Esta marca indica que lpv contiene un puntero a una estructura ADRLIST . La estructura ADRLIST contiene una o varias entradas, cada una correspondiente a un elemento seleccionado en la interfaz de usuario de WAB. Para recuperar y usar este ADRLIST, convierta lpv en un LPADRLIST. También puede usar ulFlags para determinar que WABEXTDISPLAY se está usando para inicializar una operación de interfaz IContextMenu. Si ulFlags no contiene esta marca, puede suponer de forma segura que la estructura se usa para una acción IShellPropSheetExt Interface .

WAB_DISPLAY_LDAPURL

Indica que lpsz contiene la dirección URL LDAP que se está mostrando actualmente. A veces, el WAB mostrará una hoja de propiedades en un contacto representado por una dirección URL LDAP. Aunque el contacto al que apunta la dirección URL LDAP se encapsulará en un objeto WAB y se colocará en lpPropObj, la hoja de propiedades puede acceder directamente a la dirección URL.

lpv

Tipo: LPVOID

Puntero que especifica información varias que se pasa a la aplicación. Las marcas actuales identifican la información que se representa. Si ulFlags se establece en WAB_CONTEXT_ADRLIST, lpv contiene un puntero a ADRLIST. Convierta lpv en un ADRLIST para acceder al contenido de ADRLIST. El miembro lpAdrList-cEntries> contiene el número de elementos seleccionados. Las estructuras de ADRENTRY de lpAdrList-aEntries> contienen matrices SPropValue con todas las propiedades que pertenecen a cada elemento seleccionado.

lpsz

Tipo: LPTSTR

Variable de tipo LPTSTR que especifica una cadena utilizada para pasar información varias a la aplicación. Las marcas actuales identifican la información que se representa. Si ulFlags se establece en WAB_DISPLAY_LDAPURL, el miembro lpsz contiene un puntero a una cadena terminada en NULL que contiene la dirección URL LDAP cuyas propiedades se muestran.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	wabapi.h