HrGetOneProp
Hace referencia a: Outlook 2013 | Outlook 2016
Recupera el valor de una sola propiedad de una interfaz de propiedad, es decir, una interfaz derivada de IMAPIProp.
| Propiedad | Valor |
|---|---|
| Archivo de encabezado: |
Mapiutil.h |
| Implementado por: |
MAPI |
| Llamado por: |
Aplicaciones cliente y proveedores de servicios |
HRESULT HrGetOneProp(
LPMAPIPROP pmp,
ULONG ulPropTag,
LPSPropValue FAR * ppprop
);
Parameters
Pmp
[in] Puntero a la interfaz IMAPIProp desde la que se va a recuperar el valor de propiedad.
ulPropTag
[in] Etiqueta de propiedad de la propiedad que se va a recuperar.
ppprop
[out] Puntero a un puntero a la estructura SPropValue devuelta que define el valor de propiedad recuperado.
Valor devuelto
MAPI_E_NOT_FOUND
La propiedad solicitada no está disponible en la interfaz especificada.
Comentarios
A diferencia del método IMAPIProp::GetProps , la función HrGetOneProp nunca devuelve ninguna advertencia. Dado que solo recupera una propiedad, simplemente se realiza correctamente o produce un error. Para recuperar varias propiedades, GetProps es más rápido.
Puede establecer o cambiar una sola propiedad con la función HrSetOneProp .
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| MAPIFunctions.cpp |
GetMAPIObjectType |
MFCMAPI usa el método HrGetOneProp para recuperar el tipo de un objeto. |