NPGetUser, fonction (npapi.h)

Article
08/25/2023

Récupère la valeur du nom d’utilisateur par défaut actuel ou du nom d’utilisateur utilisé pour établir une connexion réseau.

Syntaxe

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

Paramètres

[in] lpName

Pointeur vers le nom de l’appareil local qui intéresse l’appelant ou un nom distant pour une ressource à laquelle l’utilisateur s’est connecté. Ce paramètre peut être NULL ou la chaîne vide si l’appelant est intéressé par le nom de l’utilisateur actuellement connecté au système. Si un nom distant pour une ressource est passé et que l’utilisateur est connecté à cette ressource à l’aide de noms différents, il est possible qu’un fournisseur ne puisse pas résoudre le nom d’utilisateur à retourner. Dans ce cas, le fournisseur peut faire un choix arbitraire parmi les noms d’utilisateur possibles.

[out] lpUserName

Pointeur vers une mémoire tampon pour recevoir le nom d’utilisateur. Il doit s’agir d’un nom qui peut être transmis à la fonction NPAddConnection ou NPAddConnection3 pour rétablir la connexion avec le même nom d’utilisateur.

[in, out] lpnBufferLen

Pointeur vers la taille, en caractères, de la mémoire tampon lpUserName . Si l’appel échoue parce que la mémoire tampon n’est pas assez grande, cet emplacement est utilisé pour retourner la taille de mémoire tampon requise.

Valeur retournée

Si la fonction réussit, elle doit retourner WN_SUCCESS. Sinon, il doit retourner un code d’erreur, qui peut être l’un des suivants.

Code de retour	Description
WN_NOT_CONNECTED	La valeur dans le paramètre lpName n’est pas le nom d’un appareil redirigé ou d’un nom distant connecté.
WN_MORE_DATA	La mémoire tampon , lpUserName, est trop petite.
WN_NO_NETWORK	Le réseau n’est pas présent.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	npapi.h

Share via