Freigeben über


WNetGetProviderNameA-Funktion (winnetwk.h)

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 zuerst geladenen Anbieters zurück. 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

Zeiger 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 Puffergröße zurück, die (in Zeichen) zum Speichern des Anbieternamens erforderlich ist.

Windows Me/98/95: Die Größe des Puffers ist in Bytes und nicht in Zeichen angegeben. 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 lpProviderName-Parameter oder der lpBufferSize-Parameter ist ungültig.

Hinweise

Hinweis

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
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

Weitere Informationen

WNetGetNetworkInformation

WNetGetResourceInformation

WNetGetUniversalName

Übersicht über Windows-Netzwerke (WNet)

Windows-Netzwerkfunktionen