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 |
|---|---|
|
Der Puffer ist zu klein, um den Namen des Netzwerkanbieters zu speichern. |
|
Das Netzwerk ist nicht verfügbar. |
|
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 |