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.

•For each callback object registered in the list of callback objects, call the callback object'sIVdsAdviseSink::OnNotify() method with a <strong>VDS</strong>_NOTIFICATION structure with the followingattributes:•objectType member is <strong>VDS</strong>_NTT_VOLUME.•Volume member is a <strong>VDS</strong>_VOLUME_NOTIFICATION with the following attributes:•ulEvent is <strong>VDS</strong>_NF_VOLUME_MODIFY.•volumeId is the <strong>VDS</strong>_OBJECT_ID of this volume object.•Return an HRESULT indicating failure or success.3.4.5.2.30.11 IVdsVolume::ClearFlags (Opnum 13)The ClearFlags method clears flags from a volume.HRESULT ClearFlags([in] unsigned long ulFlags);ulFlags: The combination of any values, by using the bitwise OR operator, that are defined in the<strong>VDS</strong>_VOLUME_FLAG enumeration.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 ulFlags contains only valid flags defined in the <strong>VDS</strong>_VOLUME_FLAG enumeration.•If volume flags were set previously by calling SetFlags with bRevertOnClose set, and thoseflags have not yet been reverted, verify that the flags that ulFlags specifies are exactly the sameas the flags set by a call to SetFlags.The server MUST perform the following:•Clear the volume flags that ulFlags specifies. If the flags being cleared were set temporarily bycalling SetFlags with bRevertOnClose set, and those flags had not yet been reverted, theserver SHOULD NOT revert the flags automatically when a client releases the last reference tothe volume object or dismounts the volume.•For each callback object that is registered in the list of callback objects, call theIVdsAdviseSink::OnNotify() method of the callback object by using a <strong>VDS</strong>_NOTIFICATIONstructure that has the following attributes:•objectType member is <strong>VDS</strong>_NTT_VOLUME.•Volume member is a <strong>VDS</strong>_VOLUME_NOTIFICATION that has the following attributes:•ulEvent is <strong>VDS</strong>_NF_VOLUME_MODIFY.•volumeId is the <strong>VDS</strong>_OBJECT_ID of this volume object.[<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, 2011246 / 360

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

Saved successfully!

Ooh no, something went wrong!