Estrutura MONHSZSTRUCTA (ddeml.h)

Artigo
11/20/2024

Contém informações sobre um identificador de cadeia de caracteres DDE (Dynamic Data Exchange). Um aplicativo de monitoramento de DDE pode usar essa estrutura ao monitorar a atividade do componente do 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 os identificadores de cadeia de caracteres que o aplicativo criou. (O aplicativo chamou a função DdeUninitialize.)
MH_CREATE 1	Um aplicativo está criando um identificador de cadeia de caracteres. (O aplicativo chamado função DdeCreateStringHandle.)
MH_DELETE 3	Um aplicativo está excluindo um identificador de cadeia de caracteres. (O aplicativo chamado função DdeFreeStringHandle.)
MH_KEEP 2	Um aplicativo está aumentando a contagem de uso de um identificador de cadeia de caracteres. (O aplicativo chamado função de DdeKeepStringHandle.)

dwTime

Tipo: DWORD

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

hsz

Tipo: do HSZ

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

hTask

Tipo: HANDLE

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

str[1]

Tipo: TCHAR[1]

Ponteiro para a cadeia de caracteres identificada pelo membro hsz.

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
cabeçalho	ddeml.h (inclua Windows.h)

Consulte também

Conceitual

da Biblioteca de Gerenciamento dinâmico do Data Exchange

MONCBSTRUCT

MONCONVSTRUCT

MONERRSTRUCT

MONLINKSTRUCT

MONMSGSTRUCT

de referência de

Compartilhar via