13.07.2015 Views

[MS-VDS]: Virtual Disk Service (VDS) Protocol Specification

[MS-VDS]: Virtual Disk Service (VDS) Protocol Specification

[MS-VDS]: Virtual Disk Service (VDS) Protocol Specification

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

•Set the pHrResult output parameter based on the return code for the asynchronous operation. Ifthe asynchronous operation is still in progress, this parameter MUST be set to<strong>VDS</strong>_E_OPERATION_PENDING (HRESULT of 0x00042409).•Set the pulPercentCompleted output parameter based on the completion percentage of theasynchronous operation.•Return an HRESULT that indicates success or failure for the QueryStatus method.3.4.5.2.3 IVds<strong>Service</strong>Loader Methods3.4.5.2.3.1 IVds<strong>Service</strong>Loader::Load<strong>Service</strong> (Opnum 3)The Load<strong>Service</strong> method is used by client applications to load the <strong>VDS</strong> service on a remotemachine.HRESULT Load<strong>Service</strong>([in, unique, string] LPWSTR pwszMachineName,[out] IVds<strong>Service</strong>** pp<strong>Service</strong>);pwszMachineName: A pointer to a string that contains the name of the machine on which theloader should load the <strong>VDS</strong> service.pp<strong>Service</strong>: A pointer to the IVds<strong>Service</strong> interface that, if successfully completed, returns theIVds<strong>Service</strong> interface to the <strong>VDS</strong> service that runs on the machine represented bypwszMachineName.Return Values: The method MUST return zero or a non-error HRESULT (as specified in [<strong>MS</strong>-ERREF]) to indicate success or return an implementation-specific nonzero error code toindicate failure. For the HRESULT values predefined by the <strong>Virtual</strong> <strong>Disk</strong> <strong>Service</strong> Remote<strong>Protocol</strong>, see section 2.2.3.When the server receives this message, it MUST validate the following parameter:•Verify that pp<strong>Service</strong> is not NULL.The server MUST:•Load the <strong>VDS</strong> service on the computer specified by pwszMachineName parameter.•QueryInterface for the IVds<strong>Service</strong>Initialization interface.•Call the IVds<strong>Service</strong>Initialization::Initialize method, passing the pwszMachineNameparameter input to this method.•Point pp<strong>Service</strong> to the IVds<strong>Service</strong> interface for the <strong>VDS</strong> service that is loaded.•Return an HRESULT that indicates failure or success.The server object that is created when this method is called MUST implement only these interfaces:•IVds<strong>Service</strong>•IVds<strong>Service</strong>Hba•IVds<strong>Service</strong>Iscsi[<strong>MS</strong>-<strong>VDS</strong>] — v20110610<strong>Virtual</strong> <strong>Disk</strong> <strong>Service</strong> (<strong>VDS</strong>) <strong>Protocol</strong> <strong>Specification</strong>Copyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011172 / 360

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!