Partager via


Fonction MprAdminServerSetCredentials (mprapi.h)

Les fonctions MprAdminServerSetCredentials définissent la clé pré-partagée pour le serveur spécifié.

Syntaxe

DWORD MprAdminServerSetCredentials(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

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 structurées dans le paramètre lpbBuffer . Doit être zéro.

[in] lpbBuffer

Pointeur vers une structure MPR_CREDENTIALSEX_1 qui contient la clé pré-partagée pour le serveur.

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 lpbBuffer 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.

Pour supprimer la clé pré-partagée, appelez MprAdminServerSetCredentials avec le MPR_CREDENTIALSEX_1 membre dwSize 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 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

MprAdminServerGetCredentials

Fonctions d’administration du routeur

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