Função RasSetEapUserDataA (ras.h)

Use a função RasSetEapUserData para armazenar informações específicas do Protocolo de Autenticação Extensível (EAP) específicas do usuário para a entrada de catálogo telefônico 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 poderá ser NULL se a função for chamada de um processo já em execução no contexto do usuário.

[in] pszPhonebook

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o caminho completo do arquivo de catálogo telefônico (PBK). Se esse parâmetro for NULL, a função usará a lista telefônica do sistema.

[in] pszEntry

Ponteiro para uma cadeia de caracteres terminada em nulo 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 .

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
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 catálogo telefônico especificado.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	RasSetEapUserData não conseguiu 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.

Comentários

Observação

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

RasGetEapUserData

RasInvokeEapUI

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

Funções do serviço de acesso remoto