MprAdminUserSetInfo, fonction (mprapi.h)

Article
08/24/2023

La fonction MprAdminUserSetInfo définit les informations RAS pour l’utilisateur spécifié.

Syntaxe

DWORD MprAdminUserSetInfo(
  [in] LPCWSTR      lpszServer,
  [in] LPCWSTR      lpszUser,
  [in] DWORD        dwLevel,
  [in] const LPBYTE lpbBuffer
);

Paramètres

[in] lpszServer

Pointeur vers une chaîne Unicode qui spécifie le nom du serveur avec le master User Accounts Subsystem (UAS). Si le serveur d’accès à distance fait partie d’un domaine, l’ordinateur avec uaS est le contrôleur de domaine principal ou le contrôleur de domaine de sauvegarde. Si le serveur d’accès à distance ne fait pas partie d’un domaine, le serveur lui-même stocke l’UAS. Dans les deux cas, appelez la fonction MprAdminGetPDCServer pour obtenir la valeur de ce paramètre.

Si le serveur stocke lui-même l’UAS, ce paramètre peut être NULL.

[in] lpszUser

Pointeur vers une chaîne Unicode qui spécifie le nom de l’utilisateur pour lequel définir les informations RAS.

[in] dwLevel

Ce paramètre peut être égal à zéro ou un, correspondant au type de structure pointé par le paramètre lpbBuffer .

Windows NT Server 4.0 avec SP3 et versions ultérieures : Ce paramètre doit être égal à zéro.

[in] lpbBuffer

Pointeur vers une structure RAS_USER_0 ou RAS_USER_1 qui spécifie les nouvelles informations RAS pour l’utilisateur.

Windows NT Server 4.0 avec SP3 et versions ultérieures : Si le paramètre dwLevel spécifie zéro, lpbBuffer doit pointer vers une structure RAS_USER_0 .

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’une des valeurs suivantes.

Valeur	Signification
ERROR_ACCESS_DENIED	L’appelant ne dispose pas de privilèges suffisants.
ERREUR _INVALID_LEVEL	La valeur de dwLevel n’est pas valide.
ERROR_NOT_ENOUGH_MEMORY	Ressources insuffisantes pour terminer l’opération.
ERROR_NO_SUCH_USER	L’utilisateur spécifié par lpwsUserName n’existe pas sur le serveur spécifié par lpwsServerName.

Notes

Cette fonction est disponible sur Windows NT 4.0 si le redistribuable RRAS est installé. Toutefois, la version de Mprapi.dll fournie avec le redistribuable RRAS exporte la fonction en tant que RasAdminUserSetInfo plutôt que MprAdminUserSetInfo. Par conséquent, lorsque vous utilisez le redistribuable RRAS, utilisez LoadLibrary et GetProcAddress pour accéder à cette fonction.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
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