IVdsService::Unadvise method (vds.h)
[Beginning with Windows 8 and Windows Server 2012, the Virtual Disk Service COM interface is superseded by the Windows Storage Management API.]
Unregisters the caller's IVdsAdviseSink interface so that the caller no longer receives notifications from the VDS service.
Syntax
HRESULT Unadvise(
[in] DWORD dwCookie
);
Parameters
[in] dwCookie
The cookie that was returned by the IVdsService::Advise method when the IVdsAdviseSink interface was registered.
Return value
This method can return standard HRESULT values, such as E_INVALIDARG or E_OUTOFMEMORY, and VDS-specific return values. It can also return converted system error codes using the HRESULT_FROM_WIN32 macro. Errors can originate from VDS itself or from the underlying VDS provider that is being used. Possible return values include the following.
| Return code/value | Description |
|---|---|
|
The method completed successfully. |
|
The cookie does not exist. |
|
VDS failed to initialize. If an application calls this method before the service finishes initializing, the method is blocked until the initialization completes. If the initialization fails, this error is returned. |
Remarks
Use the Advise method to register your VDS application's IVdsAdviseSink interface to receive notifications from VDS. Advise returns a cookie, which you must pass back as a parameter to the Unadvise method.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | vds.h |
| Library | Uuid.lib |