3.1.5.1 IVdsService Interface

Servers implement the IVdsService interface in order to support storage management.

The UUID for this interface is {0818A8EF-9BA9-40D8-A6F9-E22833CC771E}.

The IVdsService methods are specified in section 3.4.5.2.4. A method is not listed for opnum 7 because the Virtual Disk Service Remote Protocol does not use it. Attempting to call a method with opnum 7 can result in NDR raising a RPC_X_BAD_STUB_DATA exception. For more information, see [MS-DCOM].

Methods in RPC Opnum Order

Method

Description

IsServiceReady

Determines whether a service is finished initializing.

Opnum: 3

WaitForServiceReady

Waits for VDS initialization to complete and then returns the status of the VDS initialization in the HRESULT.

Opnum: 4

GetProperties

Retrieves the properties of the service that is represented by the object that exposes this interface and method.

Opnum: 5

QueryProviders

Enumerates the providers of the server.

Opnum: 6

Opnum07NotUsedOnWire

Reserved for local use.

Opnum: 7

QueryUnallocatedDisks

Enumerates the unallocated disks on the server.

Opnum: 8

GetObject

Retrieves an IUnknown pointer to a specified object.

Opnum: 9

QueryDriveLetters

Enumerates the drive letters of the server.

Opnum: 10

QueryFileSystemTypes

Returns property details for all file systems that are known to VDS.

Opnum: 11

Reenumerate

Discovers newly added and newly removed disks and returns the status of the operation in the HRESULT.

Opnum: 12

Refresh

Refreshes the ownership and layout of disks on the server.

Opnum: 13

CleanupObsoleteMountPoints

Removes any mount points that point to volumes that no longer exist.

Opnum: 14

Advise

Registers a notification callback with the server. Clients pass the callback object to the server to receive notifications.

Opnum: 15

Unadvise

Unregisters a client from notification of changes to storage objects by the server.

Opnum: 16

Reboot

Restarts the computer on which the server is running.

Opnum: 17

SetFlags

Assigns property flags to the server.

Opnum: 18

ClearFlags

Clears property flags from the service.

Opnum: 19

All methods MUST NOT throw exceptions.

In the previous table, the term "Reserved for local use" means that the client MUST NOT send the opnum, and the server behavior is undefined because it does not affect interoperability.