Struttura MONHSZSTRUCTW (ddeml.h)

Articolo
02/29/2024

Contiene informazioni su un handle di stringa DDE (Dynamic Data Exchange). Un'applicazione di monitoraggio DDE può usare questa struttura durante il monitoraggio dell'attività del componente di gestione delle stringhe della libreria di gestione DDE.

Sintassi

typedef struct tagMONHSZSTRUCTW {
  UINT   cb;
  BOOL   fsAction;
  DWORD  dwTime;
  HSZ    hsz;
  HANDLE hTask;
  WCHAR  str[1];
} MONHSZSTRUCTW, *PMONHSZSTRUCTW;

Members

cb

Tipo: UINT

Dimensioni della struttura, in byte.

fsAction

Tipo: BOOL

Azione eseguita sulla stringa identificata dal membro hsz .

Valore	Significato
MH_CLEANUP 4	Un'applicazione libera le risorse DDE, causando l'eliminazione della stringa da parte del sistema che gestisce l'applicazione creata. L'applicazione ha chiamato la funzione DdeUninitialize .
MH_CREATE 1	Un'applicazione sta creando un handle di stringa. L'applicazione ha chiamato la funzione DdeCreateStringHandle .
MH_DELETE 3	Un'applicazione sta eliminando un handle di stringa. L'applicazione ha chiamato la funzione DdeFreeStringHandle .
MH_KEEP 2	Un'applicazione aumenta il numero di utilizzo di un handle stringa. L'applicazione ha chiamato la funzione DdeKeepStringHandle .

dwTime

Tipo: DWORD

Ora di Windows in cui viene eseguita l'azione specificata dal membro fsAction . Il tempo di Windows è il numero di millisecondi trascorsi dall'avvio del sistema.

hsz

Tipo: HSZ

Handle per la stringa. Poiché gli handle di stringa sono locali per il processo, questo membro è un atomo globale.

hTask

Tipo: HANDLE

Handle per l'attività (istanza dell'applicazione) che esegue l'azione sull'handle di stringa.

str[1]

Tipo: TCHAR[1]

Puntatore alla stringa identificata dal membro hsz .

Commenti

Nota

L'intestazione ddeml.h definisce MONHSZSTRUCT come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	ddeml.h (include Windows.h)