NDdeShareEnum-Funktion
[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.
UINT NDdeShareEnum(
_In_ LPTSTR lpszServer,
_In_ UINT nLevel,
_Out_ LPBYTE lpBuffer,
_In_ DWORD cBufSize,
_Out_ LPDWORD lpnEntriesRead,
_Out_ LPDWORD lpcbTotalAvailable
);
-
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.
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.
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 |
NDdeShareEnumW (Unicode) und NDdeShareEnumA (ANSI) |