NPGetUser, fonction (npapi.h)

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.

Configuration requise