NDdeShareEnum-Funktion

Artikel
06/13/2023

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

Ruft die Liste der verfügbaren DDE-Freigaben ab.

Syntax

UINT NDdeShareEnum(
  _In_  LPTSTR  lpszServer,
  _In_  UINT    nLevel,
  _Out_ LPBYTE  lpBuffer,
  _In_  DWORD   cBufSize,
  _Out_ LPDWORD lpnEntriesRead,
  _Out_ LPDWORD lpcbTotalAvailable
);

Parameter

lpszServer [in]: Der Name des Servers, auf dem sich der DSDM befindet.
nLevel [in]: Reserviert. Dieser Parameter muss null sein.
lpBuffer [out]: Ein Zeiger auf einen Puffer, der die Liste der DDE-Freigaben empfängt. Die Liste der DDE-Freigaben wird als Sequenz von null getrennten Zeichenfolgen gespeichert, die mit einem doppelten NULL-Zeichen am Ende enden. Dieser Parameter kann NULL sein. Wenn lpBufferNULL ist, gibt der DSDM die Größe des Puffers zurück, die erforderlich ist, um die Liste der Freigaben im lpcbTotalAvailable-Parameter zu speichern.
cBufSize [in]: Die Größe des lpBuffer-Puffers in Bytes. Dieser Parameter muss null sein, wenn lpBufferNULL ist.
lpnEntriesRead [out]: Ein Zeiger auf eine Variable, die die Gesamtzahl der aufgezählten Freigaben empfängt. Dieser Parameter darf nicht NULL sein.
lpcbTotalAvailable [out]: Ein Zeiger auf eine Variable, die die Gesamtanzahl von Bytes empfängt, die im Puffer benötigt werden, um die Liste der DDE-Freigaben zu speichern. Dieser Parameter darf nicht NULL 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. Wenn der lpBuffer-ParameterNULL ist, wird NDDE_BUF_TOO_SMALL zurückgegeben.

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	NDdeShareEnumW (Unicode) und NDdeShareEnumA (ANSI)

Siehe auch

Übersicht über den dynamischen Netzwerkdatenaustausch
Netzwerk-DDE-Funktionen

Share via