HrGetOneProp
Gilt für: Outlook 2013 | Outlook 2016
Ruft den Wert einer einzelnen Eigenschaft aus einer Eigenschaftenschnittstelle ab, d. h. einer von IMAPIProp abgeleiteten Schnittstelle.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapiutil.h |
| Implementiert von: |
MAPI |
| Aufgerufen von: |
Clientanwendungen und Dienstanbieter |
HRESULT HrGetOneProp(
LPMAPIPROP pmp,
ULONG ulPropTag,
LPSPropValue FAR * ppprop
);
Parameter
Pmp
[in] Zeiger auf die IMAPIProp-Schnittstelle , von der der Eigenschaftswert abgerufen werden soll.
ulPropTag
[in] Eigenschaftstag der abzurufenden Eigenschaft.
ppprop
[out] Zeiger auf einen Zeiger auf die zurückgegebene SPropValue-Struktur, die den abgerufenen Eigenschaftswert definiert.
Rückgabewert
MAPI_E_NOT_FOUND
Die angeforderte Eigenschaft ist über die angegebene Schnittstelle nicht verfügbar.
Hinweise
Im Gegensatz zur IMAPIProp::GetProps-Methode gibt die HrGetOneProp-Funktion nie eine Warnung zurück. Da nur eine Eigenschaft abgerufen wird, ist sie entweder erfolgreich oder schlägt fehl. Zum Abrufen mehrerer Eigenschaften ist GetProps schneller.
Sie können eine einzelne Eigenschaft mit der Funktion HrSetOneProp festlegen oder ändern.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MAPIFunctions.cpp |
GetMAPIObjectType |
MFCMAPI verwendet die HrGetOneProp-Methode , um den Typ eines Objekts abzurufen. |