Função SetNetScheduleAccountInformation (atacct.h)
[SetNetScheduleAccountInformation não está mais disponível para uso a partir de Windows 8. Em vez disso, use as Interfaces do Agendador de Tarefas 2.0.
]
A função SetNetScheduleAccountInformation define o nome e a senha da conta do serviço AT. O nome e a senha da conta de serviço at são usados como as credenciais para trabalhos agendados criados com NetScheduleJobAdd.
Sintaxe
HRESULT SetNetScheduleAccountInformation(
[in] LPCWSTR pwszServerName,
[in] LPCWSTR pwszAccount,
[in] LPCWSTR pwszPassword
);
Parâmetros
[in] pwszServerName
Uma cadeia de caracteres largos terminada em NULL para o nome do computador cujas informações de conta estão sendo definidas.
[in] pwszAccount
Um ponteiro para uma cadeia de caracteres largos terminada em NULL para a conta. Para especificar a conta do sistema local, defina esse parâmetro como NULL.
[in] pwszPassword
Um ponteiro para uma cadeia de caracteres largos terminada em NULL para a senha. Para obter informações sobre como proteger informações de senha, consulte Manipulando senhas.
Retornar valor
O valor retornado é um HRESULT. Um valor de S_OK indica que o nome da conta e a senha foram definidos com êxito. Qualquer outro valor indica uma condição de erro.
Se a função falhar, alguns dos valores retornados possíveis serão listados abaixo.
| Valor/código retornado | Descrição |
|---|---|
|
O acesso foi negado. Esse erro será retornado se o chamador não for membro do grupo Administradores. Esse erro também será retornado se o parâmetro pwszAccount não for NULL indicando que uma conta nomeada não é a conta do sistema local e o parâmetro pwszPassword estava incorreto para a conta especificada no parâmetro pwszAccount . |
|
Os dados são inválidos. Esse erro será retornado se o parâmetro pwszPassword for NULL ou o comprimento da cadeia de caracteres de parâmetro pwszPassword for muito longo. |
|
Não é possível estabelecer a existência da conta especificada. Esse erro será retornado se o parâmetro pwszAccount não for NULL indicando que uma conta nomeada não é a conta do sistema local e o parâmetro pwszAccount não foi encontrado. |
Comentários
SetNetScheduleAccountInformation representa o chamador. Somente os membros do grupo administradores local no computador em que as informações da conta de agendamento estão sendo definidas podem executar essa função com êxito. Observe que senhas NULL não são permitidas.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista, Windows XP com SP1 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | atacct.h |
| Biblioteca | Mstask.lib |
| DLL | Mstask.dll |