Compartilhar via

Função MprAdminConnectionEnumEx (mprapi.h)

  • Artigo

A função MprAdminConnectionEnumEx enumera as conexões ativas para um servidor RRAS especificado.

Sintaxe

DWORD MprAdminConnectionEnumEx(
  [in]  RAS_SERVER_HANDLE     hRasServer,
  [in]  PMPRAPI_OBJECT_HEADER pObjectHeader,
  [in]  DWORD                 dwPreferedMaxLen,
  [out] LPDWORD               lpdwEntriesRead,
  [out] LPDWORD               lpdwTotalEntries,
  [out] PRAS_CONNECTION_EX    *ppRasConn,
  [in]  LPDWORD               lpdwResumeHandle
);

Parâmetros

[in] hRasServer

Um identificador para o servidor RAS no qual as conexões são enumeradas. Obtenha esse identificador chamando MprAdminServerConnect.

[in] pObjectHeader

Um ponteiro para uma estrutura MPRAPI_OBJECT_HEADER que especifica a versão da estrutura recebida por ppRasConn.

[in] dwPreferedMaxLen

Um valor que especifica o comprimento máximo preferencial dos dados retornados em bytes de 8 bits. Se dwPrefMaxLen for -1, o buffer retornado será grande o suficiente para manter todas as informações disponíveis.

[out] lpdwEntriesRead

Um ponteiro para um DWORD que recebe o número total de conexões enumeradas da posição de currículo atual.

[out] lpdwTotalEntries

Um ponteiro para um DWORD que recebe o número total de conexões que poderiam ter sido enumeradas da posição de currículo atual.

[out] ppRasConn

Um ponteiro, na saída, para uma matriz de estruturas RAS_CONNECTION_EX que contêm as informações de conexão ativas para o servidor RRAS no hRasServer. O número de elementos de matriz é determinado pelo valor apontado por lpdwEntriesRead.

[in] lpdwResumeHandle

Um ponteiro para uma variável DWORD que especifica um identificador de currículo usado para continuar a enumeração. O parâmetro lpdwResumeHandle é NULL na primeira chamada e permanece inalterado nas chamadas subsequentes. Se o código de retorno for ERROR_MORE_DATA, outra chamada poderá ser feita usando esse identificador para recuperar mais dados. Se o identificador for NULL no retorno, a enumeração será concluída. Esse identificador é inválido para outros tipos de retorno de erro.

Retornar valor

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_ACCESS_DENIED
 O aplicativo de chamada não tem privilégios suficientes.
ERROR_DDM_NOT_RUNNING
 O DDM (Gerenciador de Discagem de Demanda) não está em execução.
ERROR_MORE_DATA
 Nem todos os dados foram retornados com essa chamada. Para obter dados adicionais, chame a função novamente usando o identificador de retomada.
ERROR_PROC_NOT_FOUND
 Não foi possível encontrar o procedimento especificado.
Outros
 Um erro de MprError.h, RasError.h ou WinError.h.

Comentários

O chamador deve liberar a memória apontada por ppRasConn chamando a função MprAdminBufferFree.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
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

MprAdminBufferFree

MprAdminConnectionEnum

MprAdminServerConnect

Funções de administração ras

Referência de administração do serviço de acesso remoto