The IGDACNetAffxAnnotationListing object is used to retrieve the list of annotations and to retrieve the annotation files from the NetAffx web site.

ConnectionIdentifier

Description	An identifier used to connect to NetAffx.
Type	BSTR
Access	Write-only
Remarks	This must be set prior to retrieving annotations from NetAffx.

UserName

Description	The user name to use to connect to NetAffx.
Type	BSTR
Access	Write-only
Remarks	This must be set prior to retrieving annotations from NetAffx.

Password

Description	The users password to use to connect to NetAffx.
Type	BSTR
Access	Write-only
Remarks	This must be set prior to retrieving annotations from NetAffx.

DataDirectory

Description	The directory where the annotations are to be downloaded to.
Type	BSTR
Access	Write-only
Remarks	This must be set prior to retrieving annotations from NetAffx.

NumAnnotations

Description	The number of annotations available from NetAffx.
Type	long
Access	Read-only
Remarks	This value is set after the call to RetrieveAnnotationList().

RetrieveAnnotationList

Description	Retrieves the list of available annotations from NetAffx.
Prototype	HRESULT RetrieveAnnotationList([out, retval] BOOL *pStatus);
Parameters	pStatus (out) - The return value.
Return	TRUE if successfully obtained the list of annotations, FALSE otherwise.
Remarks	None

GetAnnotation

Description	Returns an Annotation object for the given index.
Prototype	HRESULT GetAnnotation([in] long index, [in] IGDACNetAffxAnnotation *pAnnotation);
Parameters	index (in) - The index to the desired annotation file. pAnnotation (in/out) - The information about the requested annotation.
Return	HRESULT - S_OK if the method succeeded.
Remarks	The RetrieveAnnotationList() function must be called prior to obtaining the information. The index must be between 0 and the number of annotations (NumAnnotations).

RetrieveAnnotationFile

Description	Returns the annotation file for the given index.
Prototype	HRESULT RetrieveAnnotationFile([in] long index, [out, retval] NETAFFX_DOWNLOAD_STATUS_TYPE *pStatus);
Parameters	index (in) - The index to the desired annotation file. pStatus (out) - The return value.
Return	TRUE if successfully obtained the annotation file, FALSE otherwise.
Remarks	The RetrieveAnnotationList() function must be called prior to obtaining the information. The index must be between 0 and the number of annotations (NumAnnotations). The name and location of the annotation file retrieved is available in the Annotation object using the GetAnnotation() function. The return value (pStatus) will either be DOWNLOAD_FILE_FAILED indicating a failure to download the file, DOWNLOAD_FILE_SUCCESS indicating that the file was successfully downloaded or DOWNLOAD_FILE_NOT_UPDATED indicating that the file is already cached in the data directory and an update was not required.