Fonction MprAdminServerGetCredentials (mprapi.h)

Article
03/04/2024

La fonction MprAdminServerGetCredentials récupère la clé pré-partagée pour le serveur spécifié.

Syntaxe

DWORD MprAdminServerGetCredentials(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer
);

Paramètres

[in] hMprServer

Gérer vers un serveur Windows. Obtenez ce handle en appelant MprAdminMIBServerConnect.

[in] dwLevel

Valeur DWORD qui décrit le format dans lequel les informations sont retournées dans le paramètre lplpbBuffer . Doit être zéro.

[out] lplpbBuffer

Une fois l’exécution réussie, un pointeur vers une structure MPR_CREDENTIALSEX_1 qui contient la clé pré-partagée pour le serveur. 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_PARAMETER	Le paramètre lplpbBuffer est NULL.
ERROR_NOT_SUPPORTED	Le paramètre dwLevel n’est pas égal à zéro.
Autres	Utilisez FormatMessage pour récupérer le message d’erreur système qui correspond au code d’erreur retourné.

Remarques

Le serveur gère une seule clé pré-partagée pour tous les utilisateurs.

Configuration requise

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

Voir aussi

MPR_CREDENTIALSEX_1

MprAdminServerSetCredentials

Fonctions d’administration du routeur

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

Partager via