Partager via


MprAdminInterfaceGetCredentials, fonction (mprapi.h)

Utilisez la fonction MprAdminInterfaceGetCredentials pour récupérer le domaine, le nom d’utilisateur et le mot de passe pour la numérotation sortante sur l’interface de numérotation à la demande spécifiée.

Syntaxe

DWORD MprAdminInterfaceGetCredentials(
  [in]  LPWSTR lpwsServer,
  [in]  LPWSTR lpwsInterfaceName,
  [out] LPWSTR lpwsUserName,
  [out] LPWSTR lpwsPassword,
  [out] LPWSTR lpwsDomainName
);

Paramètres

[in] lpwsServer

Pointeur vers une chaîne Unicode terminée par un caractère Null qui spécifie le nom du routeur sur lequel exécuter cet appel.

Ce paramètre est facultatif. Si l’application appelante spécifie NULL pour ce paramètre, l’appel est exécuté sur l’ordinateur local.

[in] lpwsInterfaceName

Pointeur vers une chaîne Unicode terminée par un caractère Null qui spécifie le nom de l’interface de numérotation à la demande. Utilisez MprAdminInterfaceGetInfo pour obtenir le nom de l’interface.

[out] lpwsUserName

Pointeur vers une chaîne Unicode qui reçoit le nom de l’utilisateur. Cette chaîne doit être longue UNLEN+1.

Ce paramètre est facultatif. Si l’application appelante spécifie NULL pour ce paramètre, la fonction ne retourne pas le nom d’utilisateur.

[out] lpwsPassword

Pointeur vers une chaîne Unicode qui reçoit le mot de passe. Cette chaîne doit être de type PWLEN+1.

Ce paramètre est facultatif. Si l’application appelante spécifie NULL pour ce paramètre, la fonction ne retourne pas le mot de passe.

[out] lpwsDomainName

Pointeur vers une chaîne Unicode qui reçoit le nom de domaine. Cette chaîne doit être longue DNLEN+1.

Ce paramètre est facultatif. Si l’application appelante spécifie NULL pour ce paramètre, la fonction ne retourne pas le nom de domaine.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Valeur Signification
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY
Aucun paramètre de numérotation à la demande n’est associé à l’interface spécifiée.
ERROR_INVALID_PARAMETER
Le paramètre lpwsInterfaceName est NULL.
NO_ERROR
Les paramètres lpwsUserName, lpwsPassword et lpwsDomainName sont tous NULL.
Autres
Utilisez FormatMessage pour récupérer le message d’erreur système qui correspond au code d’erreur retourné.

Notes

Les paramètres lpwsUserName, lpwsPassword et lpwsDomainName sont facultatifs . Si l’application appelante spécifie NULL pour les trois paramètres, MprAdminInterfaceGetCredentials retourne NO_ERROR et le domaine, le nom d’utilisateur et le mot de passe ne sont pas retournés.

Les constantes UNLEN, PWLEN et DNLEN sont les longueurs maximales pour le nom d’utilisateur, le mot de passe et le nom de domaine. Ces constantes sont définies dans lmcons.h.

Notez que l’ordre des paramètres dans MprAdminInterfaceGetCredentials est différent de MprAdminInterfaceSetCredentials.

Configuration requise

   
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête mprapi.h
Bibliothèque Mprapi.lib
DLL Mprapi.dll

Voir aussi

FormatMessage

MprAdminInterfaceSetCredentials

Fonctions d’administration du routeur

Informations de référence sur la gestion des routeurs