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 auquel l’appelant s’intéresse, ou un nom distant pour une ressource à laquelle l’utilisateur a créé une connexion. 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 transmis et que l’utilisateur est connecté à cette ressource à l’aide de différents noms, 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, car la mémoire tampon n’est pas suffisamment 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 éléments suivants.

Spécifications