IMimePropertySet::GetProp method

Gets the value of a property.

Syntax

HRESULT GetProp(
  [in]      LPCSTR        pszName,
  [in]      DWORD         dwFlags,
  [in, out] LPPROPVARIANT pValue
);

Parameters

pszName [in]

Type: LPCSTR

Specifies the property name or ID.

dwFlags [in]

Type: DWORD

Specifies a bitmask that affects how to get the property value.

Value Meaning
PDF_ENCODED
0x00000001
Indicates that the value of the property is encoded in an Internet character set and possibly RFC 1522.
PDF_NAMEINDATA
0x00000002
Indicates that when getting the property value, the name of the property should be prefixed to the value.
PDF_HEADERFORMAT
0x00000004|PDF_ENCODED
Indicates that when getting the property value, the value should be in RFC 822 format.
PDF_NOCOMMENTS
0x00000008
Indicates that when getting the property value, any comments embedded in the value should be stripped out.
PDF_VECTOR
0x00000020
Indicates that when getting the value for a property that appears more than once, the values should be concatenated together (separated by carriage return line feeds).

pValue [in, out]

Type: LPPROPVARIANT

Receives the value associated with the property. The client must initialize the pValue->vt member to a VARTYPE that is supported for the corresponding property. The client is responsible for freeing this PROPVARIANT structure by calling PropVariantClear or by freeing pointers by calling IMalloc::Free.

Return value

Type: HRESULT

Returns one of the following values.

Return code Description
S_OK
Indicates success.
E_FAIL
Indicates that an unknown error has occurred.
E_INVALIDARG
Indicates that pszName or pValue is NULL.
MIME_E_NOT_FOUND
Indicates that pszName does not specify an existing property.
MIME_E_NO_DATA
Indicates that no data is associated with the property.
E_OUTOFMEMORY
Indicates that an attempt to allocate memory failed.
MIME_E_VARTYPE_NO_CONVERT
Indicates that the VARTYPE cannot be converted to the requested type.

Remarks

A property ID can also be passed into this method through the pszName parameter using the PIDTOSTR macro.

Requirements

Minimum supported client
Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Product
Outlook Express 6.0
Header
Mimeole.h
IDL
Mimeole.idl
DLL
Inetcomm.dll (version 6.0 or later)