IHTTPMailTransport::CommandBMOVE Method

Deprecated. 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, for example, "http://www.hotmail.com/inbox/mbox1/".

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, for example, "http://www.hotmail.com/inbox/mbox2/".

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.

ValueMeaning
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 codeDescription
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.

 

Remarks

Note  The IHTTPMailTransport::CommandBMOVE method is available for use in Windows XP. It might be altered or unavailable in subsequent versions.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows Server 2003

Product

Outlook Express 6.0

Header

Imnxport.h

IDL

Imnxport.idl

DLL

Inetcomm.dll (version 6.0 or later)

 

 

Send comments about this topic to Microsoft

Build date: 6/30/2011

Show: