NDdeShareGetInfo-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 DDE-Freigabeinformationen ab. Dies erfolgt in der Regel für die Bearbeitung.

Syntax

UINT NDdeShareGetInfo(
  _In_  LPTSTR  lpszServer,
  _In_  LPTSTR  lpszShareName,
  _In_  UINT    nLevel,
  _Out_ LPBYTE  lpBuffer,
  _In_  DWORD   cBufSize,
  _Out_ LPDWORD lpnTotalAvailable,
  _In_  LPWORD  lpnItems
);

Parameter

lpszServer [in]: Der Name des Servers, auf dem sich der DSDM befindet.
lpszShareName [in]: Der Freigabename, dessen Informationen aus dem DSDM abgerufen werden sollen. Dieser Parameter darf nicht NULL sein.
nLevel [in]: Die Informationsebene. Dieser Parameter muss 2 sein.
lpBuffer [out]: Ein Zeiger auf einen Puffer, der die NDDESHAREINFO-Struktur und die zugeordneten Daten empfängt, auf die von seinen Membern verwiesen wird. Dieser Parameter kann NULL sein. Wenn lpBufferNULL ist, berechnet das DSDM die Anzahl der Bytes, die zum Speichern der angeforderten Freigabeinformationen erforderlich sind, und gibt diesen Wert im Feld lpnTotalAvailable zusammen mit dem NDDE_BUF_TOO_SMALL-Fehler zurück.
cBufSize [in]: Die Größe des lpBuffer-Puffers in Bytes. Wenn lpBufferNULL ist, sollte cBufSize 0 sein.
lpnTotalAvailable [out]: Ein Zeiger auf eine Variable, die die Gesamtanzahl von Bytes empfängt, die zum Speichern der angeforderten Freigabeinformationen benötigt werden. Dieser Parameter darf nicht NULL sein.
lpnItems [in]: Ein Zeiger auf eine Elementauswahlmaske für den teilweisen Abruf von Freigabeinformationen.

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	NDdeShareGetInfoW (Unicode) und NDdeShareGetInfoA (ANSI)

Weitere Informationen

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

Share via