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 |
|