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.
| Valor | Significado |
|---|---|
|
O manipulador é inválido. |
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
| 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 |