IPropData::HrAddObjProps
Hace referencia a: Outlook 2013 | Outlook 2016
Agrega una o varias propiedades de tipo PT_OBJECT al objeto .
HRESULT HrAddObjProps(
LPSPropTagArray lpPropTagArray,
LPSPropProblemArray FAR * lppProblems
);
Parameters
lpPropTagArray
[in] Puntero a una matriz de etiquetas de propiedad que indican las propiedades que se van a agregar.
lppProblems
[entrada, salida] En la entrada, un puntero válido a una estructura SPropProblemArray o NULL. En la salida, un puntero a un puntero a una estructura que contiene información sobre las propiedades que no se pudieron agregar, o NULL. Solo se devuelve un puntero a una estructura de matriz de problemas de propiedad si se pasa un puntero válido.
Valor devuelto
S_OK
Las propiedades se agregaron correctamente.
MAPI_E_INVALID_TYPE
Se pasó un tipo de propiedad distinto de PT_OBJECT en la matriz a la que apunta el parámetro lpPropTagArray .
MAPI_E_NO_ACCESS
El objeto se ha establecido para no permitir el permiso de lectura y escritura.
MAPI_W_PARTIAL_COMPLETION
Se agregaron algunas propiedades, pero no todas.
Comentarios
El método IPropData::HrAddObjProps agrega una o varias propiedades de tipo PT_OBJECT al objeto . HrAddObjProps proporciona una alternativa al método IMAPIProp::SetProps para las propiedades de objeto, ya que las propiedades del objeto no se pueden crear llamando a SetProps. Al agregar una propiedad de objeto, la etiqueta de propiedad se incluye en la lista de etiquetas de propiedad que devuelve el método IMAPIProp::GetPropList .
Notas para los llamadores
Si HrAddObjProps devuelve MAPI_W_PARTIAL_COMPLETION y ha establecido lppProblems en un puntero válido, compruebe la estructura SPropProblemArray devuelta para averiguar qué propiedades no se agregaron. Normalmente, el único problema que se produce es la falta de memoria. Libere la estructura SPropProblemArray llamando a la función MAPIFreeBuffer cuando haya terminado con ella.
Para agregar una propiedad, el objeto de destino debe tener permiso de lectura y escritura. Si HrAddObjProps devuelve MAPI_E_NO_ACCESS, no se pueden agregar propiedades al objeto porque no permite la modificación. Para obtener permiso de lectura y escritura en un objeto antes de llamar a HrAddObjProps, llame a IPropData::HrSetObjAccess y establezca el parámetro ulAccess en IPROP_READWRITE.