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 |
---|---|
|
Aucun paramètre de numérotation à la demande n’est associé à l’interface spécifiée. |
|
Le paramètre lpwsInterfaceName est NULL. |
|
Les paramètres lpwsUserName, lpwsPassword et lpwsDomainName sont tous NULL. |
|
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
MprAdminInterfaceSetCredentials