Microsoft Windows CE 3.0  

CAMSchedule::Unadvise

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.

Removes a previously established advise link.

HRESULT Unadvise(
DWORD
dwAdviseToken
);

Parameters

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

Return Values

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.