COM ATTRIBUTES

PROPERTIES

Name

ID	1
Description	The name of the EXP file without directory path.
Type	BSTR
Length	64 characters including file extension.
Access	Read-Write
Remarks	It accepts any valid short file name with no path specified (e.g. Hu6800.EXP).  If path is specified when setting the Name property, a COM error will be thrown.  However, the DataPath property must be set to identify the actual location of the experiment file. Returns error if setting invalid file name characters: \/:;*?"<>|'`,{}[] Returns error if file name is not with ".EXP" extension.

DataPath

ID	2
Description	The directory where the EXP files are stored.
Type	BSTR
Access	Read-Write
Remarks	Returns error if setting invalid path characters: /;*?<>|'`,{}[]

LibPath

ID	3
Description	The directory where the the library files (CDF) are stored.
Type	BSTR
Access	Read-Write
Remarks	Returns error if setting invalid path characters: /;*?<>|'`,{}[]

FullPathName

ID	4
Description	The full path file name for the experiment file.
Type	BSTR
Access	Read-only
Remarks	This property is set when setting the Name property and DataPath of this interface.

ChipType

ID	5
Description	The probe array type associated with the experiment.
Type	BSTR
Access	Read-only
Remarks	Read() must be called prior to use.  Returns an empty string if the experiment file has not been read.

Date

ID	6
Description	The file creation timestamp.
Type	BSTR
Format	MMM DD YYYY HH:MM:SS AM/PM
Access	Read-only
Remarks	Read() must be called prior to use.  Returns an empty string if the experiment file has not been read.

ChipLot

ID	7
Description	The probe array lot number.
Type	BSTR
Access	Read-only
Remarks	Read() must be called prior to use.  Returns an empty string if the experiment file has not been read.

Operator

ID	8
Description	The operator defined the in experiment
Type	BSTR
Access	Read-only
Remarks	Read() must be called prior to use.  Returns an empty string if the experiment file has not been read.

SampleType

ID	9
Description	The sample type defined in the experiment.
Type	BSTR
Access	Read-only
Remarks	Read() must be called prior to use.  Returns an empty string if the experiment file has not been read.

SampleDesc

ID	10
Description	The sample description defined in the experiment.
Type	BSTR
Access	Read-only
Remarks	Read() must be called prior to use.  Returns an empty string if the experiment file has not been read.

Project

ID	11
Description	The sample project defined in the experiment.
Type	BSTR
Access	Read-only
Remarks	Read() must be called prior to use.

Comments

ID	12
Description	The comments defined in the experiment.
Type	BSTR
Access	Read-only
Remarks	Read() must be called prior to use.  Returns an empty string if the experiment file has not been read.

Reagents

ID	13
Description	The reagents defined in the experiment.
Type	BSTR
Access	Read-only
Remarks	Read() must be called prior to use.  Returns an empty string if the experiment file has not been read.

ReagentsLot

ID	14
Description	The reagent lot number defined in the experiment.
Type	BSTR
Access	Read-only
Remarks	Read() must be called prior to use.

Protocol

ID	15
Description	The fluidics protocol used in the experiment.
Type	BSTR
Access	Read-only
Remarks	Read() must be called prior to use.  Returns an empty string if the experiment file has not been read.

Station

ID	16
Description	The fluidics station number used to run the protocol.
Type	BSTR
Access	Read-only
Remarks	Read() must be called prior to use.  Returns an empty string if the experiment file has not been read.

Module

ID	17
Description	The fluidics module number used to run the protocol.
Type	BSTR
Access	Read-only
Remarks	Read() must be called prior to use.  Returns an empty string if the experiment file has not been read.

HybridizeDate

ID	18
Description	The date the fluidics protocol was run.
Type	BSTR
Format	MMM DD YYYY HH:MM:SS AM/PM
Access	Read-only
Remarks	Read() must be called prior to use.  Returns an empty string if the experiment file has not been read.

ScanPixelSize

ID	19
Description	The pixel size, in microns, used when scanning the experiment.
Type	BSTR
Access	Read-only
Remarks	Read() must be called prior to use.  Returns an empty string if the experiment file has not been read.

ScanFilter

ID	20
Description	The filter value used when scanning the experiment.
Type	BSTR
Access	Read-only
Remarks	Read() must be called prior to use.  Returns an empty string if the experiment file has not been read.

ScanDate

ID	21
Description	The date of the scan.
Type	BSTR
Format	MMM DD YYYY HH:MM:SS AM/PM
Access	Read-only
Remarks	Read() must be called prior to use.  Returns an empty string if the experiment file has not been read.

ScannerID

ID	22
Description	The ID of the scanner if set on the MAS instrument workstation.
Type	BSTR
Access	Read-only
Remarks	Read() must be called prior to use.  Returns an empty string if the experiment file has not been read.

NumberOfScans

ID	23
Description	The number of image scans.
Type	long
Access	Read-only
Remarks	Read() must be called prior to use.  Returns 0 if the experiment file has not been read.

ScannerType

ID	24
Description	The scanner type.
Type	BSTR
Access	Read-only
Read	Read() must be called prior to use.  Returns an empty string if the experiment file has not been read.

NumProtocolSteps

ID	25
Description	The number of steps in the fluidics protocol.
Type	long
Access	Read-only
Remarks	Read() must be called prior to use.  Returns 0 if the experiment file has not been read.

ServerName

ID	26
Description	This value is not used by the SDK.
Type	BSTR
Access	Read-Write
Remarks	This value is not used by the SDK.

NTUserName

ID	27
Description	This value is not used by the SDK.
Type	BSTR
Access	Read-Write
Remarks	This value is not used by the SDK.

METHODS

Exists

ID	28
Description	This function returns a flag indicating if the EXP file exists within the specified data directory.
Prototype	HRESULT Exists(BOOL *pbExists)
Parameters	BOOL *pbExists - Flag indicating existence (output)
Return	HRESULT - S_OK if successful, E_FAIL otherwise
Remarks	The Name and DataPath properties are required.

Read

ID	29
Description	Reads the contents of the EXP file into memory.
Prototype	HRESULT Read( )
Parameters	N/A
Return	HRESULT - S_OK if successful, E_FAIL otherwise
Remarks	The Name and DataPath properties are required

GetProtocolStep

ID	30
Description	This function returns one of the fluidics station protocol steps stored in the EXP file. The return string contains the name of the parameter and its value separated by a tab.
Prototype	HRESULT GetProtocolStep(long nIndex, BSTR *pStep)
Parameters	long nIndex - Protocol step index. It is 0-based and must be in between 0 and NumProtocolSteps (input) BSTR *pStep - A pointer to the protocol step string. (output)
Return	HRESULT - S_OK if successful, E_POINTER if ppsaSteps is NULL or E_FAIL otherwise
Remarks	Read() must be called prior to use.

GetProtocolSteps

ID	31
Description	This function returns one all the fluidics station protocol steps stored in the EXP file. Each string in the array contains the name of the parameter and its value separated by a tab.
Prototype	HRESULT GetProtocolSteps(SAFEARRAY(BSTR)* ppsaSteps)
Parameters	lSAFEARRAY(BSTR)* ppsaSteps - A pointer to a pointer of safe array of the protocol steps. (output)
Return	HRESULT - S_OK if successful, E_FAIL otherwise
Remarks	Read() must be called prior to use.