HrGetOneProp
适用于:Outlook 2013 | Outlook 2016
从属性接口(即派生自 IMAPIProp 的接口)检索单个属性的值。
属性 | 值 |
---|---|
标头文件: |
Mapiutil.h |
实现者: |
MAPI |
调用者: |
客户端应用程序和服务提供商 |
HRESULT HrGetOneProp(
LPMAPIPROP pmp,
ULONG ulPropTag,
LPSPropValue FAR * ppprop
);
参数
Pmp
[in]指向要从中检索属性值的 IMAPIProp 接口的指针。
ulPropTag
[in]要检索的属性的属性标记。
ppprop
[out]指向返回的定义检索属性值的 SPropValue 结构的指针的指针。
返回值
MAPI_E_NOT_FOUND
所请求的属性在指定的接口中不可用。
备注
与 IMAPIProp::GetProps 方法不同, HrGetOneProp 函数从不返回任何警告。 因为它只检索一个属性,所以它只是成功或失败。 对于检索多个属性, GetProps 速度更快。
可以使用 HrSetOneProp 函数设置或更改单个属性。
MFCMAPI 引用
有关 MFCMAPI 示例代码,请参阅下表。
文件 | 函数 | Comment |
---|---|---|
MAPIFunctions.cpp |
GetMAPIObjectType |
MFCMAPI 使用 HrGetOneProp 方法检索对象的类型。 |