MprAdminIsServiceInitialized-Funktion (mprapi.h)

Die MprAdminIsServiceInitialized-Funktion überprüft, ob der RRAS-Dienst auf einem angegebenen Server ausgeführt wird, wenn der aufrufende Prozess Zugriff hat.

Syntax

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

Parameter

[in] lpwsServerName

Ein Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Namen des abzufragenden Servers angibt. Wenn dieser Parameter NULL ist, fragt die Funktion den lokalen Computer ab.

[in] fIsServiceInitialized

In der Ausgabe ein Zeiger auf eine BOOL, der angibt, ob der RRAS-Dienst auf dem Server in lpwsServerName ausgeführt wird:

Wert	Bedeutung
TRUE	Der Dienst wird auf dem angegebenen Server ausgeführt.
FALSE	Der Dienst wird nicht auf dem angegebenen Server ausgeführt, und/oder der aufrufende Prozess hat keinen Zugriff auf den RRAS-Dienst.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Wert	Bedeutung
ERROR_INVALID_PARAMETER	Der fIsServiceInitialized-Parameter ist NULL.
ERROR_SERVICE_NOT_ACTIVE	Der RRAS-Dienst wird auf dem Server nicht ausgeführt.
ERROR_ACCESS_DENIED	Die aufrufende Anwendung verfügt nicht über ausreichende Berechtigungen.

Anforderungen

Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mprapi.h
Bibliothek	Mprapi.lib
DLL	Mprapi.dll

Weitere Informationen

MprAdminIsServiceRunning

MprConfigBufferFree

Routerverwaltungsfunktionen

Referenz zur Routerverwaltung