NDDESHAREINFO-Struktur

[Netzwerk-DDE wird nicht mehr unterstützt. Nddeapi.dll ist auf Windows Vista vorhanden, aber alle Funktionsaufrufe geben NDDE _ NICHT _ IMPLEMENTIERT zurück.]

Enthält DDE-Freigabeattribute, die vom NetDDE-Freigabedatenbank-Manager (DSDM) verwaltet werden. Der jeder DDE-Freigabe zugeordnete Sicherheitsdeskriptor wird nicht über diese Struktur übergeben, sondern über bestimmte Funktionen aufgerufen. Die NetDDE DSDM-API akzeptiert diese Struktur für set-Funktionen. für get-Funktionen gibt das DSDM die im angegebenen Puffer gepackte Struktur zusammen mit den Daten zurück, 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;

Members

lRevision

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

lpszShareName

Der Name der Freigabe. Diese Zeichenfolge darf maximal MAX _ NDDESHARENAME-Zeichen lang sein.

lShareType

Mindestens ein DDE-Freigabetypen. 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 _ GEBEN SIE _ ALTE
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 auf NULL beendete Zeichenfolgen für die DDE-, OLE- und statischen Anwendungs-/Themenpaare enthält. Der Puffer sollte das folgende Format haben:

<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, lässt die DDE-Freigabe nicht zu, dass Remotebenutzer über die DDE kommunizieren können. 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 dieser Member festgelegt ist, überprüft die DDE-Freigabe nicht, ob der aktuelle Benutzer es als vertrauenswürdig festgelegt hat, bevor die DDE-Kommunikation erlaubt wird.

fStartAppFlag

Wenn dieser Member festgelegt ist und die Freigabe vertrauenswürdig ist, um Anwendungen zu starten, versucht NetDDE, die von lpszAppTopicList angegebene Anwendung zu starten, wenn zunächst keine DDE-Konversation mit der Anwendung gestartet werden 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 wichtig, wenn fStartAppFlag aktiv ist. Der angemeldete Benutzer, in dessen Kontext die Anwendung gestartet wird, kann diese Option auch überschreiben, wenn er die Freigabe in den vertrauenswürdigen Status überschreibt. Der Standardwert für diesen Member 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 aufgelisteten Elemente. Wenn cNumItems 0 (null) ist, ist lpszItemList leer, und die Freigabeinformationen und der zugehörige Sicherheitsdeskriptor gelten für alle Elemente, die von der zugeordneten Anwendung verwendet werden.

lpszItemList

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

Requirements (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 dynamische Daten Exchange Netzwerksicherheit

Netzwerk-DDE-Strukturen

NDdeSetShareSecurity

NDdeShareSetInfo

WinMain