Partilhar 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.

Valor de retorno

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

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

Observações

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

  • Para converter o SID de 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 .

Requirements

Requirement Value
Cliente mínimo suportado Windows XP
Servidor mínimo compatível Windows Server 2003
da Plataforma de Destino Windows
Header bits.h
Library Bits.lib
de DLL QmgrPrxy.dll

Consulte também

IBackgroundCopyJob::TakeOwnership