IMimePropertySet::MoveProps method

  • Article

Moves a set of properties to another IMimePropertySet object.

Syntax

HRESULT MoveProps(
  [in] ULONG            cNames,
  [in] LPCSTR           *prgszName,
  [in] IMimePropertySet *pPropertySet
);

Parameters

cNames [in]

Type: ULONG

Specifies a ULONG that contains the number of elements in the prgszName array. A client can pass 0 for this parameter and NULL for prgszName to move all properties to pPropertySet.

prgszName [in]

Type: LPCSTR*

Specifies a pointer to an array of property names or property IDs to move. If an entry in this array is NULL, the property is skipped without the method failing.

pPropertySet [in]

Type: IMimePropertySet*

Specifies a pointer to the destination IMimePropertySet object.

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 cNames is equal to zero and prgszName is not NULL or cNames is greater than zero and prgszName is NULL. It may also indicate that pPropertySet is NULL.
E_OUTOFMEMORY
 Indicates that an attempt to allocate memory failed.

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)