Share via


IBackgroundCopyJob::GetOwner method

Retrieves the identity of the job's owner.

Syntax

HRESULT GetOwner(
  [out] LPWSTR *ppOwner
);

Parameters

  • ppOwner [out]
    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

Minimum supported client

Windows 10, version 1709 [desktop apps only]

Minimum supported server

Windows Server 2016 [desktop apps only]

Header

Deliveryoptimization.h

IDL

DeliveryOptimization.idl

Library

Dosvc.lib

DLL

Dosvc.dll

IID

IID_IBackgroundCopyJob is defined as 37668D37-507E-4160-9316-26306D150B12

See also

IBackgroundCopyJob

IBackgroundCopyJob::TakeOwnership