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

Confira também

SetNetScheduleAccountInformation