Função RtmReleaseChangedDests (rtmv2.h)

Artigo
03/01/2024

A função RtmReleaseChangedDests libera os identificadores de destino alterados.

Sintaxe

DWORD RtmReleaseChangedDests(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] RTM_NOTIFY_HANDLE NotifyHandle,
  [in] UINT              NumDests,
  [in] PRTM_DEST_INFO    ChangedDests
);

Parâmetros

[in] RtmRegHandle

Identificador para o cliente obtido de uma chamada anterior para RtmRegisterEntity.

[in] NotifyHandle

Manipule para uma notificação de alteração, obtida de uma chamada anterior para RtmRegisterForChangeNotification.

[in] NumDests

Especifica o número de destinos em ChangedDests.

[in] ChangedDests

Ponteiro para uma matriz de estruturas RTM_DEST_INFO a serem lançadas. Os destinos alterados foram obtidos de uma chamada anterior para RtmGetChangedDests.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos códigos de erro a seguir.

Valor	Significado
ERROR_INVALID_HANDLE	O manipulador é inválido.

Comentários

Sempre use essa função para liberar estruturas RTM_DEST_INFO alteradas obtidas de uma chamada para RtmGetChangedDests.

A estrutura RTM_DEST_INFO é uma estrutura de tamanho variável. Se um destino contiver informações para mais de uma exibição, o tamanho de RTM_DEST_INFO aumentará para cada exibição. Use a macro RTM_SIZE_OF_DEST_INFO para determinar o tamanho de um buffer ChangedDests a ser alocado antes de chamar essa função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	rtmv2.h
Biblioteca	Rtm.lib
DLL	Rtm.dll