Função RasGetConnectStatusA (ras.h)

Artigo
11/20/2024

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 de 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 dwSize membro da estrutura como sizeof(RASCONNSTATUS) para identificar a versão da estrutura que está sendo passada.

Valor de retorno

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.

Observações

O valor retornado para rasGetConnectStatus não é necessariamente igual ao valor do dwError membro da estrutura RASCONNSTATUS retornada pelo 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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	ras.h
biblioteca	Rasapi32.lib
de DLL	Rasapi32.dll

Consulte também

RASCONNSTATUS

RasDial

RasEnumConnections

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

Funções do Serviço de Acesso Remoto

Compartilhar via