NDDESHAREINFO-Struktur

[Netzwerk-DDE wird nicht mehr unterstützt. Nddeapi.dll ist unter Windows Vista vorhanden, aber alle Funktionsaufrufe geben NDDE_NOT_IMPLEMENTED zurück.]

Enthält DDE-Freigabeattribute, die vom NetDDE Share Database Manager (DSDM) verwaltet werden. Der sicherheitsdeskriptor, der jeder DDE-Freigabe zugeordnet ist, wird nicht über diese Struktur übergeben, sondern über bestimmte Funktionen. Die NetDDE-DSDM-API akzeptiert diese Struktur für festgelegte Funktionen. für get-Funktionen gibt die DSDM die Struktur zurück, die in den bereitgestellten Puffer gepackt ist, zusammen mit den Daten, auf die von den Membern lpszShareName, lpszAppTopicList und lpszItemList verwiesen wird.

Syntax

typedef struct _NDDESHAREINFO {
  LONG   lRevision;
  LPTSTR lpszShareName;
  LONG   lShareType;
  LPTSTR lpszAppTopicList;
  LONG   fSharedFlag;
  LONG   fService;
  LONG   fStartAppFlag;
  LONG   nCmdShow;
  LONG   qModifyId[2];
  LONG   cNumItems;
  LPTSTR lpszItemList;
} NDDESHAREINFO, *PNDDESHAREINFO;

Member

lRevision

Die Revisionsebene der NDDESHAREINFO-Struktur . Derzeit ist die Revisionsebene 1.

lpszShareName

Der Name der Freigabe. Diese Zeichenfolge darf nicht mehr als MAX_NDDESHARENAME Zeichen lang sein.

lShareType

Mindestens ein DDE-Freigabetyp. Dieser Member kann eine Kombination der folgenden unterstützten DDE-Freigabetypen sein.

Freigabetyp	Bedeutung
SHARE_TYPE_NEW 0x02	Die Freigabe enthält ein OLE-Anwendungs-/Themenpaar.
SHARE_TYPE_OLD 0x01	Die Freigabe enthält ein DDE-Anwendungs-/Themenpaar.
SHARE_TYPE_STATIC 0x04	Die Freigabe enthält ein statisches Anwendungs-/Themenpaar.

lpszAppTopicList

Ein Zeiger auf einen Puffer, der NULL-beendete Zeichenfolgen für die DDE-, OLE- und statischen Anwendungs-/Themapaare enthält. Der Puffer sollte das folgende Format aufweisen:

<DDE application name>|<DDE topic name>\0
<OLE application name>|<OLE topic name>\0
<static application name>|<static topic name>\0\0

fSharedFlag

Wenn dieser Member FALSE ist, erlaubt die DDE-Freigabe remote Benutzern nicht, mithilfe von DDE darüber zu kommunizieren. Lokale Benutzer können jedoch weiterhin über die DDE-Freigabe kommunizieren. Lokale Clientlinks werden immer impliziert, wenn die zugeordnete DACL Zugriff gewährt.

fService

Wenn dieses Element festgelegt ist, überprüft die DDE-Freigabe nicht, ob der aktuelle Benutzer ihn als vertrauenswürdig festgelegt hat, bevor die DDE-Kommunikation zugelassen wird.

fStartAppFlag

Wenn dieses Element festgelegt ist und die Freigabe als vertrauenswürdig eingestuft wird, um Anwendungen zu starten, versucht NetDDE, die von lpszAppTopicList angegebene Anwendung zu starten, wenn sie zunächst keine DDE-Konversation mit der Anwendung starten kann.

nCmdShow

Wenn NetDDE eine Anwendung startet, um eine DDE-Konversation zu initiieren, wird dieser Wert über den nCmdShow-Parameter der WinMain-Funktion an die Anwendung gesendet. Er definiert den bevorzugten Modus für das Anwendungsfenster, in dem angezeigt werden soll. Dieser Parameter ist nur dann von Bedeutung, wenn fStartAppFlag aktiv ist. Der angemeldete Benutzer, in dessen Kontext die Anwendung gestartet wird, kann diese Option auch außer Kraft setzen, wenn die Freigabe auf vertrauenswürdige status heraufstufen. Der Standardwert für dieses Element ist SW_SHOWMAXIMIZED.

qModifyId

Eine 8-Byte-Seriennummer, die die Änderungsseriennummer der DDE-Freigabe angibt. Jedes Mal, wenn die DDE-Freigabe durch einen NDdeShareSetInfo - oder NDdeSetShareSecurity-Aufruf geändert wird, werden diese Werte geändert.

cNumItems

Die Anzahl der in lpszItemList aufgeführten Elemente. Wenn cNumItems null ist, ist lpszItemList leer, und die Freigabeinformationen und der zugehörige Sicherheitsdeskriptor gelten für alle Elemente, die von der zugeordneten Anwendung verwaltet werden.

lpszItemList

Ein Zeiger auf einen Puffer, der NULL-Zeichenfolgen enthält, die die Elemente angeben, für die die Clientanwendung in einer DDE-Transaktion Beratungsschleifen anfordern oder starten kann. Wenn keine Elemente aufgeführt sind, lässt die DDE-Freigabe die Verwendung beliebiger Elemente zu. Die Anzahl der Elemente in der Liste muss mit der Anzahl von cNumItems übereinstimmen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Nddeapi.h

Weitere Informationen

Übersicht über den dynamischen Netzwerkdatenaustausch

DDE-Netzwerkstrukturen

NDdeSetShareSecurity

NDdeShareSetInfo

WinMain