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	Nddeapi.h
Bibliothek	Nddeapi.lib
DLL	Nddeapi.dll
Unicode- und ANSI-Name	NDdeShareAddW (Unicode) und NDdeShareAddA (ANSI)

Siehe auch

Übersicht über den dynamischen Netzwerkdatenaustausch

Netzwerk-DDE-Funktionen

NDDESHAREINFO

NDdeSetTrustedShare