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