IHTTPMailTransport::CommandBCOPY method

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

Sends the BCOPY command to the HTTPMail server.

Syntax

HRESULT CommandBCOPY(
  [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 copy.

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

Requirements