Função RasGetConnectStatusA (ras.h)

  • Artigo

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
ERROR_NOT_ENOUGH_MEMORY
 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

Confira também

RASCONNSTATUS

Rasdial

Rasenumconnections

Visão geral do RAS (Serviço de Acesso Remoto)

Funções do serviço de acesso remoto