Estrutura MONHSZSTRUCTA (ddeml.h)

Artigo
08/23/2023

Contém informações sobre um identificador de cadeia de caracteres DDE (Troca Dinâmica de Dados). Um aplicativo de monitoramento DDE pode usar essa estrutura ao monitorar a atividade do componente gerenciador de cadeia de caracteres da Biblioteca de Gerenciamento de DDE.

Sintaxe

typedef struct tagMONHSZSTRUCTA {
  UINT   cb;
  BOOL   fsAction;
  DWORD  dwTime;
  HSZ    hsz;
  HANDLE hTask;
  CHAR   str[1];
} MONHSZSTRUCTA, *PMONHSZSTRUCTA;

Membros

cb

Tipo: UINT

O tamanho da estrutura, em bytes.

fsAction

Tipo: BOOL

A ação que está sendo executada na cadeia de caracteres identificada pelo membro hsz .

Valor	Significado
MH_CLEANUP 4	Um aplicativo está liberando seus recursos DDE, fazendo com que o sistema exclua identificadores de cadeia de caracteres que o aplicativo criou. (O aplicativo chamado de função DdeUninitialize .)
MH_CREATE 1	Um aplicativo está criando um identificador de cadeia de caracteres. (O aplicativo chamado de função DdeCreateStringHandle .)
MH_DELETE 3	Um aplicativo está excluindo um identificador de cadeia de caracteres. (O aplicativo chamado de função DdeFreeStringHandle .)
MH_KEEP 2	Um aplicativo está aumentando a contagem de uso de um identificador de cadeia de caracteres. (O aplicativo chamado de função DdeKeepStringHandle .)

dwTime

Tipo: DWORD

A hora do Windows em que a ação especificada pelo membro fsAction ocorre. A hora do Windows é o número de milissegundos decorridos desde que o sistema foi inicializado.

hsz

Tipo: HSZ

Um identificador para a cadeia de caracteres. Como os identificadores de cadeia de caracteres são locais para o processo, esse membro é um atom global.

hTask

Tipo: HANDLE

Um identificador para a tarefa (instância do aplicativo) que executa a ação no identificador de cadeia de caracteres.

str[1]

Tipo: TCHAR[1]

Ponteiro para a cadeia de caracteres identificada pelo membro hsz .

Comentários

Observação

O cabeçalho ddeml.h define MONHSZSTRUCT como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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]
Cabeçalho	ddeml.h (inclua Windows.h)