IBackgroundCopyJob::GetOwner method (bits.h)

Article
02/22/2024

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:

To convert the string SID to a SID, call the ConvertStringSidToSid function.
To retrieve the domain and user name associated with the SID, call the LookupAccountSid function.

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