User's Manual

84 Remote Service Features
The following methods are used to directly detach the local OEMDRV
device or the network ISO image. These can be used before the previously
set exposure durations time out:
a
The
DetachDrivers()
method on the
DCIM_OSDeploymentService
class detaches and removes the
OEMDRV
device that had been
previously attached by an invocation of the
UnpackAndAttach()
method.
b
The
DetachISOImage()
method on the
DCIM_OSDeploymentService
class detaches and removes the
network share based ISO image that had been previously attached by
an invocation of the
BootToNetworkISO()
method.
Several methods described in this document return job identifiers as
output parameters. The jobs provide a means of keeping track of a
requested action that cannot be performed immediately and, because of
underlying technology constraints, will take longer than standard web
service request response timeouts. The returned job identifier can
subsequently be used in WS-MAN Enumerate or Get requests to retrieve
job object instances. Job object instances contain a job status property that
can be checked to see what state the job is in and whether it completed
successfully or encountered a problem and failed. If a job failure occurs,
the job instance also contains an error message property that provides
detailed information on the nature of the failure. Other properties contain
other error identification information that can be used to localize the error
message to the supported languages and get more detailed error
descriptions and recommended response action descriptions.
•The
GetHostMACInfo()
method on the
DCIM_OSDeploymentService
class returns an array of physical network port MAC addresses representing
all the LAN on Motherboard (LOM) ports in the system. The method
requires no input parameters.
All the
DCIM_OSDeploymentService
methods described in this
document return error codes indicating whether the method successfully
executed, an error occurred, or a job was created. Job creation occurs if the
action being performed in the method cannot be completed immediately.
Additionally, if an error occurs, the methods will also return output
parameters that include an error message (in English) and other error
identifiers that can be used to localize the error to languages supported by
the USC. The other error identifiers can be used to index into and process
LC1_3.book Page 84 Monday, December 7, 2009 3:14 PM