Função RasAdminPortGetInfo

[Essa função é fornecida apenas para compatibilidade com versões anteriores com o Windows NT Server 4.0. Ele retorna ERROR_CALL_NOT_IMPLEMENTED no Windows Server 2003. Os aplicativos devem usar a função MprAdminPortGetInfo .]

A função RasAdminPortGetInfo recupera informações sobre uma porta especificada em um servidor especificado.

Sintaxe

DWORD RasAdminPortGetInfo(
  _In_  const WCHAR               *lpszServer,
  _In_  const WCHAR               *lpszPort,
  _Out_       RAS_PORT_1          *pRasPort1,
  _Out_       RAS_PORT_STATISTICS *pRasStats,
  _Out_       RAS_PARAMETERS      **ppRasParams
);

Parâmetros

lpszServer [in]

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome do servidor RAS. Especifique o nome com caracteres "\\" à esquerda, no formato: \\servername.

lpszPort [in]

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome da porta no servidor.

pRasPort1 [out]

Ponteiro para a estrutura RAS_PORT_1 que a função preenche com informações sobre o estado da porta.

pRasStats [out]

Ponteiro para a estrutura RAS_PORT_STATISTICS que a função preenche com estatísticas sobre a porta.

ppRasParams [out]

Ponteiro para uma variável de ponteiro que recebe o endereço de uma matriz de estruturas RAS_PARAMETERS . Cada estrutura contém o nome de uma chave específica de mídia, como MAXCONNECTBPS, e seu valor associado. Quando o aplicativo for concluído com essa memória, libere-o chamando a função RasAdminFreeBuffer .

Valor retornado

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

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

Valor	Significado
ERROR_DEV_NOT_EXIST	A porta especificada é inválida.
ERROR_NOT_ENOUGH_MEMORY	Memória insuficiente para alocar um buffer para a matriz ppRasParams .

Não há informações de erro estendidas para essa função; não chame GetLastError.

Requisitos

Requisito	Valor
Fim do suporte ao cliente	Windows 2000 Professional
Fim do suporte ao servidor	Windows 2000 Server
Cabeçalho	Rassapi.h
Biblioteca	Rassapi.lib
DLL	Rassapi.dll

Confira também

Visão geral do RAS (Serviço de Acesso Remoto)

Funções de administração do servidor RAS

RAS_PARAMETERS

RAS_PORT_1

RAS_PORT_STATISTICS

RasAdminFreeBuffer