WNetGetProviderNameA-Funktion (winnetwk.h)

Artikel
11/20/2024

Die WNetGetProviderName-Funktion ruft den Anbieternamen für einen bestimmten Netzwerktyp ab.

Syntax

DWORD WNetGetProviderNameA(
  [in]      DWORD   dwNetType,
  [out]     LPSTR   lpProviderName,
  [in, out] LPDWORD lpBufferSize
);

Parameter

[in] dwNetType

Netzwerktyp, der für das Netzwerk eindeutig ist. Wenn zwei Netzwerke denselben Typ beanspruchen, gibt die Funktion den Namen des anbieters zurück, der zuerst geladen wurde. Es wird nur das hohe Wort des Netzwerktyps verwendet. Wenn ein Netzwerk einen Untertyp im unteren Wort meldet, wird er ignoriert.

Eine vollständige Liste der Netzwerktypen finden Sie in der Headerdatei Winnetwk.h.

[out] lpProviderName

Zeigen Sie auf einen Puffer, der den Namen des Netzwerkanbieters empfängt.

[in, out] lpBufferSize

Größe des An die Funktion übergebenen Puffers in Zeichen. Wenn der Rückgabewert ERROR_MORE_DATA ist, gibt lpBufferSize die erforderliche Puffergröße (in Zeichen) für den Anbieternamen zurück.

Windows Me/98/95: Die Größe des Puffers ist in Byte, nicht in Zeichen. Außerdem muss der Puffer mindestens 1 Byte lang sein.

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
ERROR_MORE_DATA	Der Puffer ist zu klein, um den Namen des Netzwerkanbieters zu speichern.
ERROR_NO_NETWORK	Das Netzwerk ist nicht verfügbar.
ERROR_INVALID_ADDRESS	Der parameter lpProviderName oder der lpBufferSize Parameter ist ungültig.

Bemerkungen

Anmerkung

Der winnetwk.h-Header definiert WNetGetProviderName 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

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winnetwk.h
Library	Mpr.lib
DLL-	Mpr.dll

Siehe auch

WNetGetNetworkInformation-

WNetGetResourceInformation-

WNetGetUniversalName

übersicht über Windows Networking (WNet)

Windows-Netzwerkfunktionen

Freigeben über