Fonction MprAdminInterfaceGetCredentialsEx (mprapi.h)

Article
02/29/2024

Utilisez la fonction MprAdminInterfaceGetCredentialsEx pour récupérer des informations d’identification étendues pour l’interface spécifiée. Utilisez cette fonction pour récupérer les informations d’identification utilisées pour les protocoles d’authentification extensibles (EAPs).

Syntaxe

DWORD MprAdminInterfaceGetCredentialsEx(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  HANDLE            hInterface,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer
);

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 retournées dans le paramètre lplpbBuffer . Les valeurs acceptables pour dwLevel incluent 0 ou 1, comme indiqué dans le tableau suivant.

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

La valeur 1 indique que les informations sont une clé pré-partagée pour l’interface, qui est dans un format chiffré.

[out] lplpbBuffer

Une fois la saisie terminée, un pointeur vers une structure MPR_CREDENTIALSEX_0 ou MPR_CREDENTIALSEX_1 . Le paramètre dwLevel indique le type de structure. Libérez la mémoire occupée par cette structure avec MprAdminBufferFree.

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.

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