Função RasAdminPortGetInfo

[Essa função é fornecida apenas para compatibilidade com versões anteriores com 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 formulário: \\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 de RAS_PORT_1 que a função preenche com informações sobre o estado da porta.

pRasStats [out]

Ponteiro para a estrutura de 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 de RAS_PARAMETERS . Cada estrutura contém o nome de uma chave específica da 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 for bem-sucedida, o valor retornado será ERROR_SUCCESS.

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

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