NPGetUser-Funktion (npapi.h)

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

Die Parameter

[in] lpName

Zeigen Sie auf den Namen des lokalen Geräts, an dem der Anrufer interessiert ist, oder 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 aktuell am System angemeldeten Benutzers interessiert ist. Wenn ein Remotename für eine Ressource übergeben wird und der Benutzer mit anderen Namen mit dieser Ressource verbunden ist, ist es möglich, dass ein Anbieter den zurückzugebenden Benutzernamen nicht auflösen kann. In diesem Fall kann der Anbieter unter den möglichen Benutzernamen eine beliebige Auswahl treffen.

[out] lpUserName

Zeigen Sie auf einen Puffer, um den Benutzernamen zu erhalten. Dies sollte ein Name sein, der an die NPAddConnection - oder NPAddConnection3-Funktion übergeben werden kann, um die Verbindung mit demselben Benutzernamen erneut herzustellen.

[in, out] lpnBufferLen

Zeigen Sie auf die Größe des lpUserName-Puffers in Zeichen. Wenn der Aufruf fehlschlägt, da 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 eine der folgenden Sein kann.

Anforderungen