Função RasSetCustomAuthDataA (ras.h)

Artigo
11/20/2024

Use a função RasSetCustomAuthData para definir informações de autenticação específicas da conexão. Essas informações não devem ser específicas para um usuário específico.

Sintaxe

DWORD RasSetCustomAuthDataA(
  [in] LPCSTR pszPhonebook,
  [in] LPCSTR pszEntry,
  [in] BYTE   *pbCustomAuthData,
  [in] DWORD  dwSizeofCustomAuthData
);

Parâmetros

[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] pbCustomAuthData

Ponteiro para um buffer que especifica os novos dados de autenticação.

[in] dwSizeofCustomAuthData

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

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 dwSizeofCustomAuthData é zero ou o parâmetro pbCustomAuthData é 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 RasSetCustomAuthData 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

rasGetCustomAuthData

rasSetEapUserData

Compartilhar via