Função RasAdminPortEnum
[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 |
|---|---|
|
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 |
|
| Biblioteca |
|
| DLL |
|