Função RasGetProjectionInfoEx (ras.h)

  • Artigo

A função RasGetProjectionInfoEx obtém informações sobre as operações de projeção de acesso remoto PPP (Protocolo Ponto a Ponto) ou IKEv2 (Internet Key Exchange versão 2) para todas as conexões RAS no cliente local.

Sintaxe

DWORD RasGetProjectionInfoEx(
  [in]      HRASCONN             hrasconn,
  [in, out] PRAS_PROJECTION_INFO pRasProjection,
  [in, out] LPDWORD              lpdwSize
);

Parâmetros

[in] hrasconn

Um identificador para a conexão RAS para a qual os pontos de extremidade do túnel devem ser alterados. Esse pode ser um identificador retornado pela função RasDial ou RasEnumConnections .

[in, out] pRasProjection

Um ponteiro para uma estrutura RAS_PROJECTION_INFO que recebe as informações de projeção para as conexões RAS.

[in, out] lpdwSize

Um ponteiro, na entrada, que especifica o tamanho, em bytes, do buffer apontado por pRasProjection. Na saída, essa variável recebe o tamanho, em bytes, do buffer necessário para armazenar o número de estruturas de RAS_PROJECTION_INFO apontadas por pRasProjection.

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_BUFFER_TOO_SMALL
 O buffer apontado por pRasProjection não é grande o suficiente para conter as informações solicitadas.
ERROR_INVALID_HANDLE
 O parâmetro hrasconn não é um identificador válido.
ERROR_INVALID_PARAMETER
 A função foi chamada com um parâmetro inválido.
ERROR_INVALID_SIZE
 O membro dwSize da estrutura apontada por pRasProjection especifica um tamanho inválido.
ERROR_PROTOCOL_NOT_CONFIGURED
 O protocolo de controle para o qual as informações foram solicitadas não foram bem-sucedidas nem falharam, pois a entrada do catálogo telefônico da conexão não exigia que uma tentativa de negociar o protocolo fosse feita.

Comentários

A projeção de acesso remoto é o processo pelo qual um servidor de acesso remoto e um cliente remoto negociam informações específicas do protocolo de rede. Um servidor de acesso remoto usa essas informações específicas do protocolo de rede para representar um cliente remoto na rede.

As informações de projeção de acesso remoto não estarão disponíveis até que o sistema operacional tenha executado o estado RASCS_Projected na conexão de acesso remoto. Se RasGetProjectionInfoEx for chamado antes do estado RASCS_Projected , ele retornará ERROR_PROJECTION_NOT_COMPLETE.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ras.h
Biblioteca Rasapi32.lib
DLL Rasapi32.dll

Confira também

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

Funções do serviço de acesso remoto