OSImageService.Import Method (ImportOSSourceDetails, String, String, SynchronizationContext)

Imports an OSImage that was generated by the Snapshot Manager tool that comes with AppDNA.

Namespace: Citrix.SDK.AppDNA
Assembly: Citrix.SDK.AppDNA (in Citrix.SDK.AppDNA.dll) Version: 7.11.0.0 (7.11.0.0)

Syntax

C

public OSImage Import(
    ImportOSSourceDetails importDetails,
    string outputFolder,
    out string logFile,
    SynchronizationContext synchronizationContext
)

VB

Public Function Import ( 
    importDetails As ImportOSSourceDetails,
    outputFolder As String,
    <OutAttribute> ByRef logFile As String,
    synchronizationContext As SynchronizationContext
) As OSImage

Parameters

 

importDetails

Type: Citrix.SDK.AppDNA.ImportOSSourceDetails
The source of the import, with attendant details.

outputFolder

Type: System.String
The full path of the folder that contains any files generated during the import.

logFile

Type: System.String
Upon return, this contains the full path to a text file containing the details of the import. This is useful when troubleshooting import errors.

synchronizationContext

Type: System.Threading.SynchronizationContext
A SynchronizationContext used to control the thread on which notifications are raised. See the remarks for more details.

Return Value

Type: OSImage
The OSImage object that represents the imported image.

Remarks

Importing utilizes multiple background worker threads. The Import object raises notification events which the user can subscribe to. In order to allow the user to control which thread the user event handling code should be called on, this function accepts a SynchronizationContext. If null is specified, then Current will be used. Note that Current may still be null, in which case there is no guarantee over which thread the event handlers will be run on. If a non-null value is passed or Current is not null, then the caller must ensure that the specified synchronization context is processing events in order to have the event handlers called. See http://msdn.microsoft.com/en-us/library/system.threading.synchronizationcontext.aspx for more information.

See Also

Reference

OSImageService Class
Import Overload
Citrix.SDK.AppDNA Namespace