Compartilhar via


Método IBackgroundCopyJob::GetOwner (bits.h)

Recupera a identidade do proprietário do trabalho.

Sintaxe

HRESULT GetOwner(
  [out] LPWSTR *pVal
);

Parâmetros

[out] pVal

Cadeia de caracteres terminada em nulo que contém a versão de cadeia de caracteres do SID que identifica o proprietário do trabalho. Chame a função CoTaskMemFree para liberar ppOwner quando terminar.

Retornar valor

Esse método retorna os seguintes valores HRESULT , bem como outros.

Código de retorno Descrição
S_OK
A identidade do proprietário do trabalho foi recuperada com êxito.
E_INVALIDARG
O parâmetro ppOwner não pode ser NULL.

Comentários

Para converter o formato de cadeia de caracteres do SID em um formato domain\user-name, que é adequado para exibição em uma interface do usuário, chame as seguintes funções:

  • Para converter o SID da cadeia de caracteres em um SID, chame a função ConvertStringSidToSid .
  • Para recuperar o domínio e o nome de usuário associados ao SID, chame a função LookupAccountSid .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP
Servidor mínimo com suporte Windows Server 2003
Plataforma de Destino Windows
Cabeçalho bits.h
Biblioteca Bits.lib
DLL QmgrPrxy.dll

Confira também

IBackgroundCopyJob::TakeOwnership