Função GetNetScheduleAccountInformation (atacct.h)
[GetNetScheduleAccountInformation 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 GetNetScheduleAccountInformation recupera o nome da conta do serviço AT.
Sintaxe
HRESULT GetNetScheduleAccountInformation(
[in] LPCWSTR pwszServerName,
[in] DWORD ccAccount,
[out] WCHAR [] wszAccount
);
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 recuperadas.
[in] ccAccount
O número de caracteres, incluindo o terminador NULL, alocado para wszAccount. O comprimento máximo permitido para esse valor é o comprimento máximo do nome de domínio mais o comprimento máximo do nome de usuário mais 2, expresso como DNLEN + UNLEN + 2. (Os dois últimos caracteres são o caractere "" e o terminador NULL.)
[out] wszAccount
Uma matriz de caracteres largos, incluindo o terminador NULL, que recebe as informações da conta.
Retornar valor
O valor retornado é um HRESULT. Um valor de S_OK indica que a função foi bem-sucedida e as informações da conta são retornadas em wszAccount. Um valor de S_FALSE indica que a função foi bem-sucedida e a conta é a conta sistema local (nenhuma informação será retornada em wszAccount). Quaisquer outros valores retornados indicam uma condição de erro.
Comentários
Para chamar com êxito a função GetNetScheduleAccountInformation , o chamador deve ter acesso de leitura à pasta de tarefas que geralmente é %windir%\tasks ou conforme definido na seguinte configuração do Registro:
HKLM\SOFTWARE\Microsoft\SchedulingAgent\TasksFolder
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 |