IHTTPMailTransport::CommandBMOVE method

[IHTTPMailTransport::CommandBMOVE is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Sends the BMOVE command to the HTTPMail server.

Syntax

HRESULT CommandBMOVE(
  [in] LPCSTR           pszSourceCollection,
  [in] LPHTTPTARGETLIST pTargets,
  [in] LPCSTR           pszDestCollection,
  [in] LPHTTPTARGETLIST pDestinations,
  [in] BOOL             fAllowRename,
  [in] DWORD            dwContext
);

Parameters

pszSourceCollection [in]

Type: LPCSTR

Specifies an LPCSTR that contains a null-terminated string that is the complete URL to the collection resource that contains the target resources.

pTargets [in]

Type: LPHTTPTARGETLIST

Specifies a pointer to a HTTPTARGETLIST structure that contains the list of target resources to move.

pszDestCollection [in]

Type: LPCSTR

Specifies an LPCSTR that contains a null-terminated string that is the complete URL to the collection resource that contains the destination resources.

pDestinations [in]

Type: LPHTTPTARGETLIST

Specifies a pointer to a HTTPTARGETLIST structure that contains the list of destination resources that exactly match up with the target resources specified by pTargets.

fAllowRename [in]

Type: BOOL

Specifies a BOOL that indicates whether the destination resources already exist and should be overwritten.

Value	Meaning
FALSE	Do not send the Overwrite request header.
TRUE	Send the Overwrite request header and set it to TRUE.

dwContext [in]

Type: DWORD

Currently unused. Should be set to zero.

Return value

Type: HRESULT

Returns one of the following values.

Return code	Description
S_OK	Indicates success.
E_INVALIDARG	Indicates that pszSourceCollection, pTargets, or pszDestCollection is NULL or that pTargets and pDestinations structures are of unequal length.
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	Imnxport.h
IDL	Imnxport.idl
DLL	Inetcomm.dll (version 6.0 or later)