NPGetUser-Funktion (npapi.h)

Artikel
03/04/2024

Ruft den Wert des aktuellen Standardbenutzernamens oder des Benutzernamens ab, der zum Herstellen einer Netzwerkverbindung verwendet wird.

Syntax

DWORD NPGetUser(
  [in]      LPWSTR  lpName,
  [out]     LPWSTR  lpUserName,
  [in, out] LPDWORD lpnBufferLen
);

Parameter

[in] lpName

Zeiger auf den Namen des lokalen Geräts, an dem der Aufrufer interessiert ist, oder auf einen Remotenamen für eine Ressource, mit der der Benutzer eine Verbindung hergestellt hat. Dieser Parameter kann NULL oder die leere Zeichenfolge sein, wenn der Aufrufer an dem Namen des Benutzers interessiert ist, der derzeit beim System angemeldet ist. Wenn ein Remotename für eine Ressource übergeben wird und der Benutzer unter anderen Namen mit dieser Ressource verbunden ist, kann ein Anbieter möglicherweise nicht auflösen, welcher Benutzername zurückgegeben werden soll. In diesem Fall kann der Anbieter eine beliebige Auswahl unter den möglichen Benutzernamen treffen.

[out] lpUserName

Zeiger auf einen Puffer, um den Benutzernamen zu empfangen. Dies sollte ein Name sein, der an die Funktion NPAddConnection oder NPAddConnection3 übergeben werden kann, um die Verbindung mit demselben Benutzernamen wiederherzustellen.

[in, out] lpnBufferLen

Zeiger auf die Größe des puffers lpUserName in Zeichen. Wenn der Aufruf fehlschlägt, weil der Puffer nicht groß genug ist, wird dieser Speicherort verwendet, um die erforderliche Puffergröße zurückzugeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, sollte sie WN_SUCCESS zurückgeben. Andernfalls sollte ein Fehlercode zurückgegeben werden, der wie folgt aussehen kann.

Rückgabecode	Beschreibung
WN_NOT_CONNECTED	Der Wert im lpName-Parameter ist nicht der Name eines umgeleiteten Geräts oder eines verbundenen Remotenamens.
WN_MORE_DATA	Der Puffer lpUserName ist zu klein.
WN_NO_NETWORK	Das Netzwerk ist nicht vorhanden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	npapi.h

Freigeben über