Compartilhar via


Método IScheduledWorkItem::GetAccountInformation (mstask.h)

[[Essa API pode estar alterada ou indisponível em versões subsequentes do sistema operacional ou do produto. Em vez disso, use as Interfaces do Agendador de Tarefas 2.0 .] ]

Recupera o nome da conta do item de trabalho.

Sintaxe

HRESULT GetAccountInformation(
  [out] LPWSTR *ppwszAccountName
);

Parâmetros

[out] ppwszAccountName

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome da conta para o item de trabalho atual. A cadeia de caracteres vazia, L"", é retornada para a conta do sistema local.

Depois de processar o nome da conta, chame CoTaskMemFree para liberar a cadeia de caracteres.

Retornar valor

O método GetAccountInformation retorna um dos valores a seguir.

Código de retorno Descrição
S_OK
A operação foi bem-sucedida.
E_INVALIDARG
Os argumentos não são válidos.
E_OUTOFMEMORY
Não existe memória suficiente.
SCHED_E_ACCOUNT_INFORMATION_NOT_SET
As informações da conta não foram definidas para o item de trabalho.
SCHED_E_NO_SECURITY_SERVICES
Os serviços de segurança estão disponíveis apenas nos sistemas operacionais Windows Server 2003, Windows 2000 e Windows XP.

Comentários

O método GetAccountInformation é para os sistemas operacionais Windows Server 2003, Windows XP e Windows 2000.

Exemplos

Para obter mais informações e um exemplo de como recuperar as informações da conta de uma tarefa, consulte Exemplo de código C/C++: Recuperando informações da conta de tarefa.

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 mstask.h
Biblioteca Mstask.lib
DLL Mstask.dll

Confira também

IScheduledWorkItem

IScheduledWorkItem::SetAccountInformation