NDdeShareGetInfo-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 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 das 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 die Member zeigen. Dieser Parameter kann NULL sein. Wenn lpBuffer NULL ist, berechnet das DSDM die Anzahl der Bytes, die zum Speichern der angeforderten Freigabeinformationen erforderlich sind, und gibt diesen Wert zusammen mit dem Fehler NDDE BUF TOO SMALL im Feld lpnTotalAvailable _ _ _ zurück.

cBufSize [ In]

Die Größe des lpBuffer-Puffers in Bytes. Wenn lpBuffer NULL ist, sollte cBufSize 0 (null) sein.

lpnTotalAvailable [ out]

Ein Zeiger auf eine Variable, die die Gesamtzahl der Bytes empfängt, die zum Speichern der angeforderten Freigabeinformationen erforderlich sind. Dieser Parameter darf nicht NULL sein.

lpnItems [ In]

Ein Zeiger auf eine Elementauswahlmaske zum Abrufen von Teilfreigabeinformationen.

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.

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 dynamische Daten Exchange Netzwerksicherheit

DDE-Netzwerkfunktionen

NDDESHAREINFO

NDdeShareSetInfo