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

The HRESULT that pHrResult references MUST return zero to indicate success, or animplementation-specific nonzero error code to indicate failure of the asynchronous operationthat is associated with the IVdsAsync object.When the server receives this message, it MUST validate the following parameters:•Verify that pHrResult is not NULL.•Verify that pAsyncOut is not NULL.The server MUST perform the following:•Wait for the asynchronous operation to complete.•If the server implements a maximum amount of time to wait for an asynchronous operation tocomplete, and that maximum time is exceeded, then the server MUST return VDS_E_TIMEOUT.The maximum amount of time is implementation-specific.•Set the pHrResult output parameter for the operation based on the return code for theasynchronous operation.•If the asynchronous operation has successfully completed, set the pAsyncOut output parameterfields based on the operation type. If the asynchronous operation has failed, this parameter maybe left uninitialized.•Return an HRESULT that indicates success or failure for the Wait method.3.4.5.2.2.3 IVdsAsync::QueryStatus (Opnum 5)The QueryStatus method retrieves the status of the asynchronous operation.HRESULT QueryStatus([out] HRESULT* pHrResult,[out] unsigned long* pulPercentCompleted);pHrResult: A pointer to a variable that receives the HRESULT that signals the current state ofthe asynchronous operation.pulPercentCompleted: A pointer to a variable that receives the completion percentage of theasynchronous operation. If the asynchronous operation is in progress, the value MUST bebetween 0 and 99. If the operation has finished, the value MUST be 100. If the progress of theoperation cannot be estimated, the value MUST be 0.Return Values: The method MUST return zero or a non-error HRESULT (as specified in [MS-ERREF]) to indicate success or return an implementation-specific nonzero error code toindicate failure. For the HRESULT values predefined by the Virtual Disk Service RemoteProtocol, see section 2.2.3.When the server receives this message, it MUST validate the following parameters:•Verify that pHrResult is not NULL.•Verify that pulPercentCompleted is not NULL.The server MUST perform the following:[MS-VDS] — v20110610Virtual Disk Service (VDS) Protocol SpecificationCopyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011171 / 360