Skip to content

Latest commit

 

History

History
139 lines (99 loc) · 3.83 KB

nf-rtmv2-rtmreleasechangeddests.md

File metadata and controls

139 lines (99 loc) · 3.83 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:rtmv2.RtmReleaseChangedDests
RtmReleaseChangedDests function (rtmv2.h)
The RtmReleaseChangedDests function releases the changed destination handles.
RtmReleaseChangedDests
RtmReleaseChangedDests function [RAS]
_rtmv2ref_rtmreleasechangeddests
rras.rtmreleasechangeddests
rtmv2/RtmReleaseChangedDests
rras\rtmreleasechangeddests.htm
RRAS
542cb23f-81c2-4b29-b049-ebb5827b1d62
12/05/2018
RtmReleaseChangedDests, RtmReleaseChangedDests function [RAS], _rtmv2ref_rtmreleasechangeddests, rras.rtmreleasechangeddests, rtmv2/RtmReleaseChangedDests
rtmv2.h
Windows
None supported
Windows 2000 Server [desktop apps only]
Rtm.lib
Rtm.dll
Windows
19H1
RtmReleaseChangedDests
rtmv2/RtmReleaseChangedDests
c++
APIRef
kbSyntax
DllExport
Rtm.dll
RtmReleaseChangedDests

RtmReleaseChangedDests function

-description

The RtmReleaseChangedDests function releases the changed destination handles.

-parameters

-param RtmRegHandle [in]

Handle to the client obtained from a previous call to RtmRegisterEntity.

-param NotifyHandle [in]

Handle to a change notification, obtained from a previous call to RtmRegisterForChangeNotification.

-param NumDests [in]

Specifies the number of destinations in ChangedDests.

-param ChangedDests [in]

Pointer to an array of RTM_DEST_INFO structures to release. The changed destinations were obtained from a prior call to RtmGetChangedDests.

-returns

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following error codes.

Value Meaning
ERROR_INVALID_HANDLE
The handle is invalid.
 
 

-remarks

Always use this function to release changed RTM_DEST_INFO structures obtained from a call to RtmGetChangedDests.

The RTM_DEST_INFO structure is a variable-sized structure. If a destination contains information for more than one view, the size of RTM_DEST_INFO increases for each view. Use the RTM_SIZE_OF_DEST_INFO macro to determine how large a ChangedDests buffer to allocate before calling this function.

-see-also

RTM_DEST_INFO

RtmGetChangeStatus

RtmGetChangedDests

RtmIgnoreChangedDests

RtmIsMarkedForChangeNotification

RtmMarkDestForChangeNotification