Função RtmReleaseDests (rtmv2.h)

A função RtmReleaseDests libera os identificadores de destino.

Sintaxe

DWORD RtmReleaseDests(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] UINT              NumDests,
  [in] PRTM_DEST_INFO    DestInfos
);

Parâmetros

[in] RtmRegHandle

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

[in] NumDests

Especifica o número de destinos em DestInfos.

[in] DestInfos

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

Valor retornado

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

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

Comentários

Não use essa função para liberar RTM_DEST_INFO estruturas obtidas de uma chamada para RtmGetChangedDests. Em vez disso, use RtmReleaseChangedDests .

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 DestInfos a ser alocado antes de chamar essa função.

Requisitos

Confira também

RTM_DEST_INFO

RtmCreateDestEnum

RtmDeleteEnumHandle

RtmGetEnumDests