MprAdminIsServiceInitialized function

The MprAdminIsServiceInitialized function checks whether the RRAS service is running on a specified server if the calling process has access.

Syntax


DWORD APIENTRY MprConfigServerSetInfo(
  _In_ LPWSTR   lpwsServerName,
  _In_ BOOL     *fIsServiceInitialized
);

Parameters

lpwsServerName [in]

A pointer to a null-terminated Unicode string that specifies the name of the server to query. If this parameter is NULL, the function queries the local machine.

fIsServiceInitialized [in]

On output, a pointer to a BOOL that specifies whether the RRAS service is running on the server in lpwsServerName:

ValueMeaning
TRUE

The service is running on the specified server.

FALSE

The service is not running on the specified server and/or the calling process does not have access to the RRAS service.

 

Return value

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following error codes.

ValueMeaning
ERROR_INVALID_PARAMETER

The fIsServiceInitialized parameter is NULL.

ERROR_SERVICE_NOT_ACTIVE

The RRAS service is not running on the server.

ERROR_ACCESS_DENIED

The calling application does not have sufficient privileges.

 

Remarks

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Mprapi.h

Library

Mprapi.lib

DLL

Mprapi.dll

See also

Router Administration Functions
Router Management Reference
MprAdminIsServiceRunning
MprConfigBufferFree

 

 

Community Additions

ADD
Show: