MONHSZSTRUCTA-Struktur (ddeml.h)

Artikel
08/23/2023

Enthält Informationen zu einem DDE-Zeichenfolgenhandle (Dynamic Data Exchange). Eine DDE-Überwachungsanwendung kann diese Struktur verwenden, wenn die Aktivität der Zeichenfolgen-Manager-Komponente der DDE-Verwaltungsbibliothek überwacht wird.

Syntax

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

Member

cb

Typ: UINT

Die Größe der Struktur in Bytes.

fsAction

Typ: BOOL

Die Aktion, die für die vom hsz-Element identifizierte Zeichenfolge ausgeführt wird.

Wert	Bedeutung
MH_CLEANUP 4	Eine Anwendung gibt ihre DDE-Ressourcen frei, was dazu führt, dass das System Zeichenfolgenhandles löscht, die die Anwendung erstellt hatte. (Die Anwendung mit dem Namen DdeUninitialize-Funktion .)
MH_CREATE 1	Eine Anwendung erstellt ein Zeichenfolgenhandle. (Die Anwendung hat die DdeCreateStringHandle-Funktion aufgerufen.)
MH_DELETE 3	Eine Anwendung löscht ein Zeichenfolgenhandle. (Die Anwendung hat die DdeFreeStringHandle-Funktion aufgerufen.)
MH_KEEP 2	Eine Anwendung erhöht die Nutzungsanzahl eines Zeichenfolgenhandles. (Die Anwendung hat die DdeKeepStringHandle-Funktion aufgerufen.)

dwTime

Art: DWORD

Die Windows-Zeit, zu der die vom fsAction-Member angegebene Aktion stattfindet. Windows-Zeit ist die Anzahl der Millisekunden, die seit dem Start des Systems verstrichen sind.

hsz

Typ: HSZ

Ein Handle für die Zeichenfolge. Da Zeichenfolgenhandles für den Prozess lokal sind, ist dieser Member ein globales Atom.

hTask

Typ: HANDLE

Ein Handle für die Aufgabe (Anwendung instance), die die Aktion für das Zeichenfolgenhandle ausführt.

str[1]

Typ: TCHAR[1]

Zeiger auf die vom hsz-Element identifizierte Zeichenfolge.

Hinweise

Hinweis

Der ddeml.h-Header definiert MONHSZSTRUCT als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	ddeml.h (Windows.h einschließen)