IMimePropertySet::SetProp method

Sets the value of the specified property.

Syntax

HRESULT SetProp(
  [in] LPCSTR         pszName,
  [in] DWORD          dwFlags,
  [in] LPCPROPVARIANT pValue
);

pszName [in]

Type: LPCSTR

Specifies the property name or ID.

dwFlags [in]

Type: DWORD

Specifies a bitmask that affects how the property value is stored.

Value	Meaning
PDF_ENCODED 0x00000001	Indicates that the value of the property is encoded in an Internet character set and possibly RFC 1522.
PDF_SAVENOENCODE 0x00000010	Indicates that when setting an address type header, the property value should not be re-encoded when the header is saved.

pValue [in]

Type: LPCPROPVARIANT

Specifies the value to set for the property.

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_OUTOFMEMORY	Indicates that an attempt to allocate memory failed.
E_INVALIDARG	Indicates that pszName or pValue is NULL. Might also indicate that pValue->vt specifies a VARTYPE that is not supported or that its corresponding member in the PROPVARIANT structure is invalid, such as NULL pointer.
MIME_E_READ_ONLY	Indicates that the property is read-only, that is, the property has the MPF_READONLY flag set in the property schema.
MIME_E_INVALID_HEADER_NAME	Indicates that pszName is a new property that contains invalid characters.
MIME_E_NOT_FOUND	Indicates that pszName does not specify an existing property.

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


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)