Share via


MprAdminIsServiceInitialized, fonction (mprapi.h)

La fonction MprAdminIsServiceInitialized vérifie si le service RRAS s’exécute sur un serveur spécifié si le processus appelant a accès.

Syntaxe

DWORD MprAdminIsServiceInitialized(
  [in] LPWSTR lpwsServerName,
  [in] BOOL   *fIsServiceInitialized
);

Paramètres

[in] lpwsServerName

Pointeur vers une chaîne Unicode terminée par null qui spécifie le nom du serveur à interroger. Si ce paramètre a la valeur NULL, la fonction interroge l’ordinateur local.

[in] fIsServiceInitialized

Sur la sortie, pointeur vers un BOOL qui spécifie si le service RRAS s’exécute sur le serveur dans lpwsServerName :

Valeur Signification
TRUE
Le service s’exécute sur le serveur spécifié.
FALSE
Le service n’est pas en cours d’exécution sur le serveur spécifié et/ou le processus appelant n’a pas accès au service RRAS.

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_INVALID_PARAMETER
Le paramètre fIsServiceInitialized est NULL.
ERROR_SERVICE_NOT_ACTIVE
Le service RRAS n’est pas en cours d’exécution sur le serveur.
ERROR_ACCESS_DENIED
L’application appelante ne dispose pas de privilèges suffisants.

Spécifications

   
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête mprapi.h
Bibliothèque Mprapi.lib
DLL Mprapi.dll

Voir aussi

MprAdminIsServiceRunning

MprConfigBufferFree

Fonctions d’administration du routeur

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