ListManager.ExtractMailingList Method (PIA)
Use this method to create a new Mailing list from a Generic list.
Definition
[Visual Basic .NET]
Imports Microsoft.CommerceServer.Interop.Targeting
…
Public Function ExtractMailingList(srcList As Object,
reslistName As String,
reslistDesc As String,
userFlags As Integer,
bAsync As Integer,
Optional ByRef pvarOpID As Object) As Object
[C#]
using Microsoft.CommerceServer.Interop.Targeting;
…
public object ExtractMailingList(objectsrcList,
stringreslistName,
stringreslistDesc,
intuserFlags,
int bAsync,
ref objectpvarOpID);
Parameters
[Visual Basic .NET]
- srcList
An Object that contains the ID or name of the generic source list. - reslistName
A String that contains the new mailing list name. - reslistDesc
A String that contains the description of the new mailing list. - userFlags
An Integer that contains application-specific user flags. Not used by the ListManager object. - bAsync
An Integer that specifies whether the export operation is performed synchronously or asynchronously. A value of 1 indicates asynchronous processing. - pvarOpID
An optional Object used to return an Operation ID.
[C#]
- srcList
An object that contains the ID or name of the generic source list. - reslistName
A string that contains the new mailing list name. - reslistDesc
A string that contains the description of the new mailing list. - userFlags
An int that contains application-specific user flags. Not used by the ListManager object. - bAsync
An int that specifies whether the export operation is performed synchronously or asynchronously. A value of 1 indicates asynchronous processing. - pvarOpID
A reference to an object used to return an Operation ID.
Return Values
[Visual Basic .NET] If this method completes successfully, it returns an Object that contains the ID of the new list.
[C#] This method returns a reference to an object used to return the ID of the new list.
Exceptions
This method may throw one of many mapped exceptions or an exception of type COMException. See Standard COM Errors for additional details.
[Visual Basic .NET]
The following table shows the custom COM errors that a COMException can wrap.
Value | Description |
---|---|
&H8C400007 | The specified list has already been created. |
&H8C400008 | The specified list is currently busy with another operation. |
&H8C40001D | The specified list is in a FAILED state and may not be used for the operation. |
&H8C400006 | The specified list does not exist. |
&H8C40000D | The list is designated as a Mailable list but does not contain an rcp_email column. |
&H8C400011 | The operation requires a Mailable list and the specified list is not a Mailable list. |
&H8C40000B | The operation was canceled. |
&H8C400003 | Error while executing SQL/ADO operation. |
&H8C40000E | The list is designated as a User list but does not contain an rcp_guid column. |
&H80040007 | The ListManager object has not been properly initialized. |
[C#]
The following table shows the custom COM errors that a COMException can wrap.
Value | Description |
---|---|
0x8C400007 | The specified list has already been created. |
0x8C400008 | The specified list is currently busy with another operation. |
0x8C40001D | The specified list is in a FAILED state and may not be used for the operation. |
0x8C400006 | The specified list does not exist. |
0x8C40000D | The list is designated as a Mailable list but does not contain an rcp_email column. |
0x8C400011 | The operation requires a Mailable list and the specified list is not a Mailable list. |
0x8C40000B | The operation was canceled. |
0x8C400003 | Error while executing SQL/ADO operation. |
0x8C40000E | The list is designated as a User list but does not contain an rcp_guid column. |
0x80040007 | The ListManager object has not been properly initialized. |
Remarks
The source list must be a Mailable list (contains an rcp_email column). Any duplicate e-mail addresses are removed in the result list.
[Visual Basic .NET]
Example
' oListID & pvarOpId are Objects
oListID = oListManager.ExtractMailingList("{454799A2-312B-4F5F-90A0-" & _
"F514FBA0EC5A}", "TequilaBuyers1", "Tequilla buyers in January", 0, _
1, pvarOpID)
Requirements
Namespace: Microsoft.CommerceServer.Interop.Targeting
Platforms: Windows 2000, Windows Server 2003
Assembly: listmanagerlib (in listmanagerlib.dll)
See Also
Copyright © 2005 Microsoft Corporation.
All rights reserved.