Função RasAdminPortEnum

Artigo
06/13/2023

[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 MprAdminPortEnum .]

A função RasAdminPortEnum enumera todas as portas no servidor RAS especificado. Para cada porta no servidor, a função retorna a estrutura RAS_PORT_0 que contém informações sobre a porta.

Sintaxe

DWORD RasAdminPortEnum(
  _In_  const WCHAR       *lpszServer,
  _Out_       PRAS_PORT_0 *ppRasPort0,
  _Out_       WORD        *pcEntriesRead
);

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.
ppRasPort0 [out]: Ponteiro para uma variável que recebe um ponteiro para um buffer que contém uma matriz de estruturas de RAS_PORT_0 . Quando o aplicativo tiver terminado com a memória, libere-o chamando a função RasAdminFreeBuffer .
pcEntriesRead [out]: Ponteiro para uma variável de 16 bits que recebe o número total de estruturas RAS_PORT_0 retornadas na matriz ppRasPort0 .

Valor retornado

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

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

Valor	Significado
NERR_ItemNotFound	Nenhuma porta pode ser enumerada. Isso pode ocorrer porque todas as portas configuradas no servidor estão sendo usadas para discagem.

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_PORT_0
RasAdminFreeBuffer

Compartilhar via