DTS Programming

DTSMessageVersionID Property

The DTSMessageVersionID property sets or returns the globally unique identifier (GUID) of the Data Transformation Services (DTS) package version that is the source of the message this DTSMessageQueueTask object is to receive.

Applies To

DTSMessageQueueTask Object

Syntax

object.DTSMessageVersionID [= GUID]

Part	Description
object	Expression that evaluates to a DTSMessageQueueTask object
GUID	The GUID of the package version that is the message source

Data Type

String

Modifiable

Read/write

Prototype (C/C++)

HRESULT DTSMessageVersionID(BSTR* pVal);

HRESULT DTSMessageVersionID(BSTR pVal);

Remarks

The DTSMessageVersionID affects only DTSMessageQueueTask objects that are message receivers.

To determine the version ID of a DTS package, open the package in DTS Designer. In the Package/Properties dialog box, click the General tab.

The syntax of GUIDs is:

{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}

where X represents hexadecimal digits. The groupings are 8, 4, 4, 4, and 12 digits. The curly brackets are required. Spaces cannot be embedded for readability.

The property also can be referenced through the Properties collection of the Task object with the following code:

Set taskprops = task.Properties
taskprops("DTSMessageVersionID") [= GUID]

Example

The following example assigns a GUID string to the DTSMessageVersionID property:

oCustTask.DTSMessageVersionID = _
      "{4E078447-0EFE-11D3-8DFE-00C04FD7B78D}"