IBackgroundCopyJob::GetOwner method (bits.h)

Retrieves the identity of the job's owner.

Syntax

HRESULT GetOwner(
  [out] LPWSTR *pVal
);

Parameters

[out] pVal

Null-terminated string that contains the string version of the SID that identifies the job's owner. Call the CoTaskMemFree function to free ppOwner when done.

Return value

This method returns the following HRESULT values, as well as others.

Return code Description
S_OK
Job owner's identity was successfully retrieved.
E_INVALIDARG
The ppOwner parameter cannot be NULL.

Remarks

To convert the string format of the SID into a domain\user-name format, which is suitable for display in a user interface, call the following functions:

Requirements

Requirement Value
Minimum supported client Windows XP
Minimum supported server Windows Server 2003
Target Platform Windows
Header bits.h
Library Bits.lib
DLL QmgrPrxy.dll

See also

IBackgroundCopyJob::TakeOwnership