Função RasGetConnectStatusA (ras.h)
A função RasGetConnectStatus recupera informações sobre o status atual da conexão de acesso remoto especificada. Um aplicativo pode usar essa chamada para determinar quando uma chamada RasDial assíncrona é concluída.
Sintaxe
DWORD RasGetConnectStatusA(
[in] HRASCONN unnamedParam1,
[in, out] LPRASCONNSTATUSA unnamedParam2
);
Parâmetros
[in] unnamedParam1
Especifica a conexão de acesso remoto para a qual recuperar o status. Esse identificador deve ter sido obtido de RasDial ou RasEnumConnections.
[in, out] unnamedParam2
Ponteiro para a estrutura RASCONNSTATUS que, na saída, recebe as informações de status.
Na entrada, defina o membro dwSize da estrutura como sizeof (RASCONNSTATUS) para identificar a versão da estrutura que está sendo passada.
Retornar valor
Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.
Se a função falhar, o valor retornado será um dos seguintes códigos de erro ou um valor de Códigos de Erro de Roteamento e Acesso Remoto ou Winerror.h.
| Valor | Significado |
|---|---|
|
A função não pôde alocar memória suficiente para concluir a operação. |
Comentários
O valor retornado para RasGetConnectStatus não é necessariamente igual ao valor do membro dwError da estrutura RASCONNSTATUS retornado por RasGetConnectStatus. O valor retornado de RasGetConnectStatus indica erros que ocorrem durante a chamada de função RasGetConnectStatus , enquanto o membro dwError indica erros que impediram que a conexão fosse estabelecida.
Observação
O cabeçalho ras.h define RasGetConnectStatus como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | ras.h |
| Biblioteca | Rasapi32.lib |
| DLL | Rasapi32.dll |