Fonction MprAdminServerConnect (mprapi.h)
La fonction MprAdminServerConnect établit une connexion à un routeur dans le but d’administrer ce routeur. Appelez cette fonction avant d’effectuer d’autres appels au serveur. Utilisez le handle retourné dans les appels suivants pour administrer les interfaces sur le serveur.
Syntaxe
DWORD MprAdminServerConnect(
[in, optional] LPWSTR lpwsServerName,
[out] MPR_SERVER_HANDLE *phMprServer
);
Paramètres
[in, optional] lpwsServerName
Pointeur vers une chaîne Unicode terminée par null qui spécifie le nom du serveur distant. Si ce paramètre a la valeur NULL, la fonction retourne un handle à l’ordinateur local.
[out] phMprServer
Pointeur vers une variable HANDLE qui reçoit un handle vers le serveur. Utilisez ce handle dans les appels suivants pour administrer 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 |
|---|---|
|
L’application appelante ne dispose pas de privilèges suffisants. |
|
Cette fonction a été appelée avec le paramètre phMprServer égal à NULL. |
|
L’ordinateur spécifié n’exécute pas le service Routage et RAS. |
Notes
MprAdminIsServiceRunning doit être utilisé pour déterminer la status du service RRAS sur le serveur distant. MprAdminServerConnect n’interroge pas le service RRAS lors de l’établissement d’une connexion.
Spécifications
| 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 |