Fonction MprAdminInterfaceSetCredentialsEx (mprapi.h)

Article
08/24/2023

Utilisez la fonction MprAdminInterfaceSetCredentialsEx pour définir des informations d’identification étendues pour une interface. Utilisez cette fonction pour définir les informations d’identification utilisées pour les protocoles d’authentification extensibles (EAPs).

Syntaxe

DWORD MprAdminInterfaceSetCredentialsEx(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

Paramètres

[in] hMprServer

Gérer vers un routeur. Ce handle est obtenu à partir d’un appel précédent à MprAdminServerConnect.

[in] hInterface

Gérer l’interface. Ce handle est obtenu à partir d’un appel précédent à MprAdminInterfaceCreate.

[in] dwLevel

Valeur DWORD qui décrit le format dans lequel les informations sont structurées dans le paramètre lpbBuffer . Les valeurs acceptables pour dwLevel incluent 0 ou 1, comme indiqué dans le tableau suivant. La valeur 1 indique que les informations sont une clé pré-partagée pour l’interface.

Valeur	Structure Format
0	Windows 2000 Server : MPR_CREDENTIALSEX_0
1	Windows Server 2003 ou version ultérieure : MPR_CREDENTIALSEX_1

[in] lpbBuffer

Pointeur vers une structure MPR_CREDENTIALSEX_0 ou MPR_CREDENTIALSEX_1 . Le paramètre dwLevel indique le type de structure.

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_ACCESS_DENIED	L’application appelante ne dispose pas de privilèges suffisants.
ERROR_INVALID_HANDLE	La valeur hInterface n’est pas valide.
ERROR_INVALID_PARAMETER	Le paramètre lplpbBuffer est NULL.
ERROR_NOT_ENOUGH_MEMORY	Ressources insuffisantes pour terminer l’opération.
ERROR_NOT_SUPPORTED	La valeur dwLevel n’est pas valide.

Remarques

Pour supprimer une clé pré-partagée, appelez MprAdminInterfaceSetCredentials avec le membre dwSize de la structure MPR_CREDENTIALSEX_1 défini sur zéro.

Configuration requise

Condition requise	Valeur
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