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
);

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

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

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.

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