Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

Removes a previously established advise link.

Syntax 

HRESULT Unadvise(
  DWORD 
dwAdviseToken
);

Parameters

dwAdviseToken

Identifier (cookie) of the link that is being reset. This is the value returned by CAMSchedule::AddAdvisePacket.

Return Value

Returns S_OK if successful; otherwise, returns S_FALSE.

Remarks

This member function is modeled after the IReferenceClock::Unadvisemethod. Call Unadviseto remove the previously established clock advise links.

Unadviseshould be called for unexpired single-shot advise requests.

Calling Unadvisewith the token of an already expired event causes no problems, so applications can choose to always call Unadviseon their single-shot events without fear of problems.

Requirements

Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment,
Version 2.12 requires DXPAK 1.0 or later