Função RasSetEapUserDataA (ras.h)

Artigo
11/20/2024

Use a função RasSetEapUserData para armazenar informações do Protocolo de Autenticação Extensível (EAP) específicas do usuário para a entrada de lista telefônica especificada no registro.

Sintaxe

DWORD RasSetEapUserDataA(
  [in] HANDLE hToken,
  [in] LPCSTR pszPhonebook,
  [in] LPCSTR pszEntry,
  [in] BYTE   *pbEapData,
  [in] DWORD  dwSizeofEapData
);

Parâmetros

[in] hToken

Manipule para um token de acesso primário ou de representação que representa o usuário para o qual armazenar dados. Esse parâmetro pode ser NULL se a função for chamada de um processo já em execução no contexto do usuário.

[in] pszPhonebook

Ponteiro para um cadeia de caracteresterminada nula que especifica o caminho completo do arquivo PBK (phone-book). Se esse parâmetro for NULL, a função usará a lista telefônica do sistema.

[in] pszEntry

Ponteiro para um cadeia de caracteresterminada nula que especifica um nome de entrada existente.

[in] pbEapData

Ponteiro para os dados a serem armazenados para o usuário.

[in] dwSizeofEapData

Especifica o tamanho dos dados apontados pelo parâmetro pbEapData.

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
E_INVALIDARG	O parâmetro dwSizeofEapData é zero ou o parâmetro pbEapData é NULL.
ERROR_CANNOT_OPEN_PHONEBOOK	RasSetEapUserData não pôde abrir o arquivo de lista telefônica especificado.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	RasSetEapUserData não pôde encontrar a entrada especificada na lista telefônica.
Outros	Use FormatMessage para recuperar a mensagem de erro do sistema que corresponde ao código de erro retornado.

Observações

Nota

O cabeçalho ras.h define RasSetEapUserData 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

rasGetEapUserData

RasInvokeEapUI

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

Funções do Serviço de Acesso Remoto

Compartilhar via