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.

Result of requeryAction server MUST takeVolume currently in list not found Remove volume from list; see section 3.4.5.1.63.4.5.2.4.11 IVds<strong>Service</strong>::CleanupObsoleteMountPoints (Opnum 14)The CleanupObsoleteMountPoints method removes any mount points that point to volumes thatno longer exist.HRESULT CleanupObsoleteMountPoints();This method has no parameters.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 requery the assigned mount points from theoperating system, remove mount points from the operating system if they are assigned to volumesthat no longer exist, and return an HRESULT indicating failure or success.3.4.5.2.4.12 IVds<strong>Service</strong>::Advise (Opnum 15)The Advise method registers a notification callback with the server. Clients pass the callback objectto the server to receive notifications.HRESULT Advise([in] IVdsAdviseSink* pSink,[out] DWORD* pdwCookie);pSink: A pointer to an IVdsAdviseSink interface of the callback object to register with the serverfor notification of object changes.pdwCookie: A pointer to a variable that, if the operation is successfully completed, receives aunique cookie value that the client can later use to unregister the callback object fromreceiving notification changes from the service. For information about how to register callbackobjects, see section 3.3.1.1.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 parameters:•Verify that pSink is not NULL.•Verify that pdwCookie is not NULL.The server MUST perform the following:[<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, 2011178 / 360

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

Saved successfully!

Ooh no, something went wrong!