NDdeTrustedShareEnum-Funktion
[Netzwerk-DDE wird nicht mehr unterstützt. Nddeapi.dll ist auf Windows Vista vorhanden, aber alle Funktionsaufrufe geben NDDE _ NICHT _ IMPLEMENTIERT zurück.]
Ruft die Namen aller Netzwerk-DDE-Freigaben ab, die im Kontext des aufrufenden Prozesses als vertrauenswürdig eingestuft werden.
Syntax
UINT NDdeTrustedShareEnum(
_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 das DSDM befindet.
-
nLevel [ In]
-
Reserviert. Dieser Parameter muss 0 (null) sein.
-
lpBuffer [ out]
-
Ein Zeiger auf einen Puffer, der die Liste der vertrauenswürdigen DDE-Freigaben empfängt. Die Liste der vertrauenswürdigen DDE-Freigaben wird als Sequenz von nulltrennten Zeichenfolgen zurückgegeben, die mit einem doppelten NULL-Zeichen am Ende enden. Dieser Parameter kann NULL sein. Wenn lpBuffer NULL ist, gibt das DSDM die Puffergröße zurück, die erforderlich ist, um die Liste der Freigaben im Feld lpcbTotalAvailable zu enthalten.
-
cBufSize [ In]
-
Die Größe des lpBuffer-Puffers in Bytes. Dieser Parameter muss 0 (null) sein, wenn lpBuffer NULL ist.
-
lpnEntriesRead [ out]
-
Ein Zeiger auf eine Variable, die die Gesamtzahl der vertrauenswürdigen Freigaben empfängt, die aufzählt werden. Dieser Parameter darf nicht NULL sein.
-
lpcbTotalAvailable [ out]
-
Ein Zeiger auf eine Variable, die die Gesamtzahl der Bytes empfängt, die zum Speichern der Liste vertrauenswürdiger DDE-Freigaben erforderlich sind. Dieser Parameter darf nicht NULL sein.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert NDDE _ NO _ ERROR.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Fehlercode, der durch Aufrufen von NDdeGetErrorStringin eine Textfehlermeldung übersetzt werden kann. Wenn der lpBuffer-Parameter NULL ist, wird NDDE _ BUF _ TOO SMALL _ zurückgegeben.
Requirements (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 |
NDdeTrustedShareEnumW (Unicode) und NDdeTrustedShareEnumA (ANSI) |