Partager via

NPGetUser, fonction (npapi.h)

  • Article

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