Função RasSetEntryDialParamsA (ras.h)
A função RasSetEntryDialParams altera as informações de conexão salvas pela última chamada bem-sucedida para a função RasDial ou RasSetEntryDialParams para uma entrada de catálogo telefônico especificada.
Sintaxe
DWORD RasSetEntryDialParamsA(
[in] LPCSTR unnamedParam1,
[in] LPRASDIALPARAMSA unnamedParam2,
[in] BOOL unnamedParam3
);
Parâmetros
[in] unnamedParam1
Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o caminho completo e o nome de arquivo de um arquivo de catálogo telefônico (PBK). Se esse parâmetro for NULL, a função usará o arquivo de catálogo telefônico padrão atual. O arquivo de catálogo telefônico padrão é aquele selecionado pelo usuário na folha de propriedades Preferências do Usuário da caixa de diálogo Rede Discada .
Windows Me/98/95: Esse parâmetro sempre deve ser NULL. A rede discada armazena entradas de catálogo telefônico no registro em vez de em um arquivo de catálogo telefônico.
[in] unnamedParam2
Ponteiro para a estrutura RASDIALPARAMS que especifica os parâmetros de conexão a serem associados à entrada do catálogo telefônico. RasSetEntryDialParams usa os membros da estrutura da seguinte maneira.
Membro | Significado |
---|---|
|
Deve especificar o tamanho de (RASDIALPARAMS) para identificar a versão da estrutura. |
|
Uma cadeia de caracteres terminada em nulo que identifica a entrada do catálogo telefônico para a qual definir parâmetros. |
|
Não usado. Defina como NULL. |
|
Uma cadeia de caracteres terminada em nulo que contém o número de telefone de retorno de chamada. Se szCallbackNumber for uma cadeia de caracteres vazia ( "" ), o número de retorno de chamada não será alterado. |
|
Uma cadeia de caracteres terminada em nulo que contém o nome de logon do usuário associado a essa entrada. Se szUserName for uma cadeia de caracteres vazia, o nome de usuário não será alterado. |
|
Uma cadeia de caracteres terminada em nulo que contém a senha para o usuário especificado por szUserName. Se szUserName for uma cadeia de caracteres vazia, a senha não será alterada. Se szPassword for uma cadeia de caracteres vazia e fRemovePassword for FALSE, a senha será definida como a cadeia de caracteres vazia. Se fRemovePassword for TRUE, a senha armazenada nesta entrada de catálogo telefônico para o usuário especificado por szUserName será removida, independentemente do conteúdo da cadeia de caracteres szPassword .
Windows NT 4.0: a senha é alterada para a cadeia de caracteres especificada por szPassword, independentemente de szUserName ser uma cadeia de caracteres vazia. Windows XP/2000: Se szPassword contiver o identificador de senha retornado por RasGetCredentials ou RasGetEntryDialParams, RasSetEntryDialParams retornará com êxito sem alterar nenhuma senha salva no momento. |
|
Uma cadeia de caracteres terminada em nulo que contém o nome do domínio no qual fazer logon. Se szDomain for uma cadeia de caracteres vazia, o nome de domínio não será alterado. |
|
Especifica o índice (baseado em um) da subentrada inicial a ser discada ao estabelecer a conexão. |
|
Especifica um valor definido pelo aplicativo que o RAS passa para a função de retorno de chamada RasDialFunc2 . |
[in] unnamedParam3
Especifica se a senha armazenada da entrada do catálogo telefônico deve ser removida para o usuário indicado por lprasdialparams-szUserName>. Se fRemovePassword for TRUE, a senha será removida. Definir fRemovePassword como TRUE equivale a marcar a caixa de marcar "Cancelar Salvamento de Senha" na Rede Discada. Ao definir a senha ou outras propriedades de uma entrada de catálogo telefônico, defina fRemovePassword comoFALSE.
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 | Descrição |
---|---|
|
O endereço ou buffer especificado por lprasdialparams é inválido. |
|
A lista telefônica está corrompida ou está faltando componentes. |
|
A entrada da lista telefônica não existe. |
Comentários
Para criar uma nova entrada de catálogo telefônico, use a função RasSetEntryProperties .
Windows XP ou posterior: Não use a função RasSetEntryDialParams . Para definir as credenciais de uma entrada de catálogo telefônico, use a função RasSetCredentials . Defina os membros não credenciais de RASDIALPARAMS (por exemplo , szCallbackNumber, dwSubEntry ou dwCallbackId) diretamente na estrutura RASDIALPARAMS passada como um parâmetro para a função RasDial .
Observação
O cabeçalho ras.h define RasSetEntryDialParams 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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de