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
E_ACCESSDENIED 0x080070005	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 .
HRESULT_FROM_WIN32(ERROR_INVALID_DATA) 0x08007000d	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.
SCHED_E_ACCOUNT_NAME_NOT_FOUND 0x80041310	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

Confira também

GetNetScheduleAccountInformation