IMimePropertySet::SetProp method

  • Article

Sets the value of the specified property.

Syntax

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

Parameters

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.

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_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.

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)