NDdeTrustedShareEnum-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 Namen aller DDE-Netzwerkfreigaben 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 der DSDM befindet.

nLevel [in]

Reserviert. Dieser Parameter muss 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 null getrennten Zeichenfolgen zurückgegeben, die mit einem doppelten NULL-Zeichen am Ende enden. Dieser Parameter kann NULL sein. Wenn der lpBufferNULL ist, gibt der DSDM die Größe des Puffers zurück, der erforderlich ist, um die Liste der Freigaben im Feld lpcbTotalAvailable 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 vertrauenswürdigen Freigaben empfängt, die aufgelistet 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 der vertrauenswürdigen DDE-Freigaben erforderlich sind. 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	NDdeTrustedShareEnumW (Unicode) und NDdeTrustedShareEnumA (ANSI)

Siehe auch

Übersicht über den dynamischen Netzwerkdatenaustausch

Netzwerk-DDE-Funktionen