HrGetOneProp
Aplica-se a: Outlook 2013 | Outlook 2016
Recupera o valor de uma única propriedade de uma interface de propriedade, ou seja, uma interface derivada de IMAPIProp.
| Propriedade | Valor |
|---|---|
| Arquivo de cabeçalho: |
Mapiutil.h |
| Implementado por: |
MAPI |
| Chamado por: |
Aplicativos cliente e provedores de serviços |
HRESULT HrGetOneProp(
LPMAPIPROP pmp,
ULONG ulPropTag,
LPSPropValue FAR * ppprop
);
Parâmetros
Pmp
[in] Ponteiro para a interface IMAPIProp da qual o valor da propriedade deve ser recuperado.
Ulproptag
[in] Marca de propriedade da propriedade a ser recuperada.
ppprop
[out] Ponteiro para um ponteiro para a estrutura SPropValue retornada definindo o valor da propriedade recuperada.
Valor de retorno
MAPI_E_NOT_FOUND
A propriedade solicitada não está disponível na interface especificada.
Comentários
Ao contrário do método IMAPIProp::GetProps , a função HrGetOneProp nunca retorna nenhum aviso. Como recupera apenas uma propriedade, ela simplesmente é bem-sucedida ou falha. Para recuperar várias propriedades, GetProps é mais rápido.
Você pode definir ou alterar uma única propriedade com a função HrSetOneProp .
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| MAPIFunctions.cpp |
GetMAPIObjectType |
O MFCMAPI usa o método HrGetOneProp para recuperar o tipo de objeto. |