NDdeShareAdd-Funktion
[Netzwerk-DDE wird nicht mehr unterstützt. Nddeapi.dll ist unter Windows Vista vorhanden, aber alle Funktionsaufrufe geben NDDE_NOT_IMPLEMENTED zurück.]
Erstellt und fügt dem DDE-Freigabedatenbank-Manager (DSDM) eine neue DDE-Freigabe hinzu.
Syntax
UINT NDdeShareAdd(
_In_ LPTSTR lpszServer,
_In_ UINT nLevel,
_In_ PSECURITY_DESCRIPTOR pSD,
_In_ LPBYTE lpBuffer,
_In_ DWORD cBufSize
);
Parameter
-
lpszServer [in]
-
Der Name des Servers, dessen DSDM geändert werden soll.
-
nLevel [in]
-
Die Informationsebene. Dieser Parameter muss 2 sein.
-
pSD [in]
-
Ein Zeiger auf eine SECURITY_DESCRIPTOR Struktur, die dieser Freigabe zugeordnet werden soll und für die Zugriffsprüfungen bei nachfolgenden Initialen dieser Freigabe ausgeführt werden. Dieser Parameter kann NULL sein. In diesem Fall erstellt der DSDM einen Standardsicherheitsdeskriptor, der dem Besitzer "Vollzugriff" und "Lesen und Verknüpfen" für alle Benutzer gewährt.
-
lpBuffer [in]
-
Ein Zeiger auf die NDDESHAREINFO-Struktur , die die ApplicationTopic-Liste definiert, die der erstellten DDE-Freigabe sowie anderen Parametern zugeordnet ist. Dieser Parameter darf nicht NULL sein.
-
cBufSize [in]
-
Die Größe der lpBuffer-Struktur in Bytes. Dieser Parameter darf nicht 0 sein.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert NDDE_NO_ERROR.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Fehlercode, der durch Aufrufen von NDdeGetErrorString in eine Textfehlermeldung übersetzt werden kann.
Bemerkungen
Bevor ein Client eine Verbindung mit der DDE-Freigabe herstellen kann, muss er mit NDdeSetTrustedShare vertrauenswürdig sein.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
NDdeShareAddW (Unicode) und NDdeShareAddA (ANSI) |