Fonction MprAdminServerConnect (mprapi.h)

  • Article

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
ERROR_ACCESS_DENIED
 L’application appelante ne dispose pas de privilèges suffisants.
RPC_S_INVALID_BINDING
 Cette fonction a été appelée avec le paramètre phMprServer égal à NULL.
RPC_S_UNKNOWN_IF
 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

Voir aussi

MprAdminServerDisconnect

Fonctions d’administration du routeur

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