Função DdeAbandonTransaction (ddeml.h)

Artigo
08/23/2023

Abandona a transação assíncrona especificada e libera todos os recursos associados à transação.

Sintaxe

BOOL DdeAbandonTransaction(
  [in] DWORD idInst,
  [in] HCONV hConv,
  [in] DWORD idTransaction
);

Parâmetros

[in] idInst

Tipo: DWORD

O identificador de instância do aplicativo obtido por uma chamada anterior para a função DdeInitialize .

[in] hConv

Tipo: HCONV

Um identificador para a conversa na qual a transação foi iniciada. Se esse parâmetro for 0L, todas as transações serão abandonadas (ou seja, o parâmetro idTransaction será ignorado).

[in] idTransaction

Tipo: DWORD

O identificador da transação a ser abandonada. Se esse parâmetro for 0L, todas as transações ativas na conversa especificada serão abandonadas.

Valor retornado

Tipo: BOOL

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

Se a função falhar, o valor retornado será zero.

A função DdeGetLastError pode ser usada para obter o código de erro, que pode ser um dos seguintes valores:

Comentários

Somente um aplicativo cliente DDE (Troca Dinâmica de Dados) deve chamar DdeAbandonTransaction. Se o aplicativo de servidor responder à transação depois que o cliente tiver chamado DdeAbandonTransaction, o sistema descartará os resultados da transação. Essa função não tem efeito sobre transações síncronas.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ddeml.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll