NetWkstaTransportEnum-Funktion (lmwksta.h)

Artikel
03/04/2024

Die NetWkstaTransportEnum-Funktion stellt Informationen zu Transportprotokollen bereit, die vom Redirector verwaltet werden. Dabei handelt es sich um die Software auf dem Clientcomputer, die Dateianforderungen an den Servercomputer generiert.

Syntax

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportEnum(
  [in]      LPTSTR  servername,
  [in]      DWORD   level,
  [out]     LPBYTE  *bufptr,
  [in]      DWORD   prefmaxlen,
  [out]     LPDWORD entriesread,
  [out]     LPDWORD totalentries,
  [in, out] LPDWORD resume_handle
);

Parameter

[in] servername

Ein Zeiger auf eine Zeichenfolge, die den DNS- oder NetBIOS-Namen des Remoteservers angibt, auf dem die Funktion ausgeführt werden soll. Wenn dieser Parameter NULL ist, wird der lokale Computer verwendet.

[in] level

Die Ebene der für die Daten angeforderten Informationen. Dieser Parameter kann der folgende Wert sein.

Wert	Bedeutung
0	Zurückgeben von Informationen zum Arbeitsstationstransportprotokoll. Der bufptr-Parameter verweist auf ein Array von WKSTA_TRANSPORT_INFO_0 Strukturen.

[out] bufptr

Ein Zeiger auf den Puffer, der die Daten empfängt. Das Format dieser Daten hängt vom Wert des Ebenenparameters ab. Dieser Puffer wird vom System zugewiesen und muss mithilfe der NetApiBufferFree-Funktion freigegeben werden. Beachten Sie, dass Sie den Puffer auch dann freigeben müssen, wenn die Funktion mit ERROR_MORE_DATA oder NERR_BufTooSmall fehlschlägt.

[in] prefmaxlen

Die bevorzugte maximale Länge der zurückgegebenen Daten in Bytes. Wenn Sie MAX_PREFERRED_LENGTH angeben, ordnet die Funktion den für die Daten erforderlichen Arbeitsspeicher zu. Wenn Sie in diesem Parameter einen anderen Wert angeben, kann die Anzahl der Von der Funktion zurückgegebenen Bytes eingeschränkt werden. Wenn die Puffergröße nicht ausreicht, um alle Einträge aufzunehmen, gibt die Funktion ERROR_MORE_DATA oder NERR_BufTooSmall zurück. Weitere Informationen finden Sie unter Netzwerkverwaltungsfunktionspuffer und Netzwerkverwaltungsfunktionspufferlängen.

[out] entriesread

Ein Zeiger auf einen Wert, der die Anzahl der tatsächlich aufgelisteten Elemente empfängt.

[out] totalentries

Ein Zeiger auf einen Wert, der die Gesamtanzahl von Einträgen empfängt, die aus der aktuellen Position des Fortsetzens hätten aufgezählt werden können. Beachten Sie, dass Anwendungen diesen Wert nur als Hinweis betrachten sollten.

[in, out] resume_handle

Ein Zeiger auf einen Wert, der ein Lebenslaufhandle enthält, das zum Fortsetzen einer vorhandenen Arbeitsstationstransportsuche verwendet wird. Das Handle sollte beim ersten Aufruf 0 sein und für nachfolgende Aufrufe unverändert bleiben. Wenn der resumehandle-Parameter ein NULL-Zeiger ist, wird kein Resume-Handle gespeichert.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NERR_Success.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Fehlercodes sein.

Rückgabecode	Beschreibung
ERROR_MORE_DATA	Weitere Einträge sind verfügbar. Geben Sie einen ausreichend großen Puffer an, um alle Einträge zu empfangen.
ERROR_INVALID_LEVEL	Der level-Parameter, der angibt, welche Ebene an Datenstrukturinformationen verfügbar ist, ist ungültig. Dieser Fehler wird zurückgegeben, wenn der Levelparameter als anderer Wert als null angegeben wird.
ERROR_INVALID_PARAMETER	Mindestens ein Parameter war ungültig. Dieser Fehler wird zurückgegeben, wenn die parameter bufptr oder die entriesread-Parameter NULL-Zeiger sind.
ERROR_NOT_ENOUGH_MEMORY	Für die Verarbeitung der Anforderung war nicht genügend Arbeitsspeicher verfügbar.
ERROR_NOT_SUPPORTED	Die Anforderung wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn ein Remoteserver im Servername-Parameter angegeben wurde und diese Anforderung auf dem Remoteserver nicht unterstützt wird.
NERR_BufTooSmall	Weitere Einträge sind verfügbar. Geben Sie einen ausreichend großen Puffer an, um alle Einträge zu empfangen. Dieser Fehlercode ist in der Headerdatei Lmerr.h definiert.

Hinweise

Für die erfolgreiche Ausführung der NetWkstaTransportEnum-Funktion ist keine spezielle Gruppenmitgliedschaft erforderlich.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	lmwksta.h (lm.h einschließen)
Bibliothek	Netapi32.lib
DLL	Netapi32.dll