MprAdminInterfaceSetCredentials, fonction (mprapi.h)

Article
08/24/2023

Utilisez la fonction MprAdminInterfaceSetCredentials pour définir le domaine, le nom d’utilisateur et le mot de passe qui seront utilisés pour la numérotation sortante sur l’interface de numérotation à la demande spécifiée.

Syntaxe

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

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.

[in] lpwsUserName

Pointeur vers une chaîne Unicode terminée par un caractère Null qui spécifie le nom d’utilisateur.

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

[in] lpwsDomainName

Pointeur vers une chaîne Unicode terminée par un caractère Null qui spécifie le nom de domaine.

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

[in] lpwsPassword

Pointeur vers une chaîne Unicode terminée par un caractère Null qui spécifie le mot de passe.

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

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_INVALID_PARAMETER	Au moins un des éléments suivants est vrai : Le paramètre lpwsInterfaceName a la valeur NULL ou est plus long que MAX_INTERFACE_NAME_LEN. Au moins l’un des paramètres lpwsUserName, lpwsPassword et lpwsDomainName est trop long et, par conséquent, non valide. Pour plus d'informations, consultez la section Notes.
ERROR_NOT_ENOUGH_MEMORY	Mémoire insuffisante pour créer une structure de données contenant les informations d’identification.
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, MprAdminInterfaceSetCredentials supprime toutes les informations d’identification pour cette interface.

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 MprAdminInterfaceSetCredentials est différent de MprAdminInterfaceGetCredentials.

Spécifications


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