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 |
|---|---|
|
A porta especificada é inválida. |
|
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 |
|
| Biblioteca |
|
| DLL |
|