Compartilhar via


Função MprAdminIsServiceInitialized (mprapi.h)

A função MprAdminIsServiceInitialized verifica se o serviço RRAS está em execução em um servidor especificado se o processo de chamada tem acesso.

Sintaxe

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

Parâmetros

[in] lpwsServerName

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome do servidor a ser consultado. Se esse parâmetro for NULL, a função consultará o computador local.

[in] fIsServiceInitialized

Na saída, um ponteiro para um BOOL que especifica se o serviço RRAS está em execução no servidor em lpwsServerName:

Valor Significado
TRUE
O serviço está em execução no servidor especificado.
FALSE
O serviço não está em execução no servidor especificado e/ou o processo de chamada não tem acesso ao serviço RRAS.

Valor retornado

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro.

Valor Significado
ERROR_INVALID_PARAMETER
O parâmetro fIsServiceInitialized é NULL.
ERROR_SERVICE_NOT_ACTIVE
O serviço RRAS não está em execução no servidor.
ERROR_ACCESS_DENIED
O aplicativo de chamada não tem privilégios suficientes.

Requisitos

   
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mprapi.h
Biblioteca Mprapi.lib
DLL Mprapi.dll

Confira também

MprAdminIsServiceRunning

MprConfigBufferFree

Funções de administração do roteador

Referência de gerenciamento de roteador