WNetGetNetworkInformationA-Funktion (winnetwk.h)
Die WNetGetNetworkInformation-Funktion gibt erweiterte Informationen zu einem bestimmten Netzwerkanbieter zurück, dessen Name von einer vorherigen Netzwerkaufzählung zurückgegeben wurde.
Syntax
DWORD WNetGetNetworkInformationA(
[in] LPCSTR lpProvider,
[out] LPNETINFOSTRUCT lpNetInfoStruct
);
Parameter
[in] lpProvider
Zeiger auf eine konstante NULL-endende Zeichenfolge, die den Namen des Netzwerkanbieters enthält, für den Informationen erforderlich sind.
[out] lpNetInfoStruct
Zeiger auf eine NETINFOSTRUCT-Struktur . Die Struktur beschreibt die Merkmale des Netzwerks.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode, z. B. einer der folgenden Werte.
Rückgabecode | Beschreibung |
---|---|
|
Der lpProvider-Parameter stimmt mit keinem ausgeführten Netzwerkanbieter überein. |
|
Das cbStructure-Element der NETINFOSTRUCT-Struktur enthält keine gültige Strukturgröße. |
Hinweise
Hinweis
Der winnetwk.h-Header definiert WNetGetNetworkInformation als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | winnetwk.h |
Bibliothek | Mpr.lib |
DLL | Mpr.dll |