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 |
|---|---|
|
Job owner's identity was successfully retrieved. |
|
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 |