Função MprAdminPortGetInfo (mprapi.h)

  • Artigo

A função MprAdminPortGetInfo obtém informações para uma porta específica.

Sintaxe

DWORD MprAdminPortGetInfo(
  [in]  RAS_SERVER_HANDLE hRasServer,
  [in]  DWORD             dwLevel,
  [in]  HANDLE            hPort,
  [out] LPBYTE            *lplpbBuffer
);

Parâmetros

[in] hRasServer

Manipule para o computador servidor RAS no qual coletar informações de porta. Obtenha esse identificador chamando MprAdminServerConnect.

[in] dwLevel

Um valor DWORD que descreve o formato no qual as informações são retornadas no parâmetro lplpbBuffer . Os valores aceitáveis para dwLevel incluem 0 e 1, conforme listado na tabela a seguir.

Valor Formato de estrutura
0 RAS_PORT_0
1 RAS_PORT_1

[in] hPort

Manipule para a porta para a qual coletar informações. Obtenha esse identificador chamando MprAdminPortEnum.

[out] lplpbBuffer

Após a conclusão bem-sucedida, um ponteiro para uma estrutura que descreve a porta. Essas estruturas são do tipo RAS_PORT_0 ou RAS_PORT_1 , dependendo do valor do parâmetro dwLevel . Libere essa memória chamando MprAdminBufferFree.

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 códigos de erro a seguir.

Valor Significado
ERROR_ACCESS_DENIED
 O aplicativo de chamada não tem privilégios suficientes.
ERROR_DDM_NOT_RUNNING
 O Gerenciador de Discagem de Demanda (DDM) não está em execução, possivelmente porque o DIM (Gerenciador de Interface Dinâmica) está configurado para ser executado somente em uma LAN.
ERROR_INVALID_PARAMETER
 Pelo menos um dos seguintes parâmetros é NULL ou não aponta para memória válida: lplpBuffer, lpdwEntriesRead ou lpdwTotalEntries.
ERROR_INVALID_PORT_HANDLE
 O parâmetro hPort é inválido.
ERROR_NOT_SUPPORTED
 O parâmetro dwLevel não é zero.
Outros
 Um erro de MprError.h, RasError.h ou WinError.h.
 
 

Comentários

Essa função estará disponível no Windows NT 4.0 se o RRAS redistribuível estiver instalado. No entanto, a versão do Mprapi.dll que acompanha o RRAS redistribuível exporta a função como RasAdminPortGetInfo em vez de MprAdminPortGetInfo. Portanto, ao usar o RRAS redistribuível, use LoadLibrary e GetProcAddress para acessar essa função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mprapi.h
Biblioteca Mprapi.lib
DLL Mprapi.dll

Confira também

MprAdminBufferFree

MprAdminPortEnum

MprAdminServerConnect

Funções de administração ras

Referência de Administração do Serviço de Acesso Remoto