IBackgroundCopyJob3：：SetFileACLFlags 方法（bits2_0.h）

指定使用 SMB 下载或上传文件时要维护的所有者和 ACL 信息。

Syntax

HRESULT SetFileACLFlags(
  [in] DWORD Flags
);

参数

[in] Flags

标识使用 SMB 传输文件时要维护的所有者和 ACL 信息的标志。 对此方法的后续调用将覆盖以前的标志。 指定 0 以从作业中删除标志。 可以指定以下标志的任意组合。

返回值

此方法返回以下 HRESULT 值以及其他值。

注解

这些标志适用于指定 SMB 协议的远程文件名。 BITS 忽略 HTTP 传输的标志。

BITS 传播 SMB 文件的文件时间戳和属性（未扩展属性）。

BITS 在文件传输完成时将所有者和 ACL 信息应用于文件，而不是 创建 临时传输文件时。 BITS 在创建临时传输文件时不指定安全描述符（该文件从目标目录继承 ACL 信息）。 如果传输的数据很敏感，应用程序应在目标目录中指定适当的 ACL，以防止未经授权的访问。

若要确保在作业中的所有文件上设置适当的所有者和 ACL 信息，请在创建作业之后以及调用 IBackgroundCopyJob：：Resume 方法之前调用此方法。 否则，设置标志之前传输的文件将不包含相应的所有者和 ACL 信息。

此方法在 XCopy DOS 命令后建模。

如果下载到 FAT 文件系统，则不会维护所有者和 ACL 信息。

如果用户在本地和远程计算机上没有复制所有者或 ACL 信息的权限，则 BITS 会将作业置于暂时性错误状态，并将错误代码设置为 E_ACCESSDENIED。

例子

以下示例演示如何调用 SetFileACLFlags 方法，以指定要与 BITS 下载的文件一起维护的所有者和 ACL 信息。 该示例假定 IBackgroundCopyJob 变量 pJob 有效，指向新作业并挂起。

     IBackgroundCopyJob *pJob;
     IBackgroundCopyJob3 *pJob3 = NULL;

     //Need to query the IBackgroundCopyJob interface for an IBackgroundCopyJob3
     //interface pointer. The IBackgroundCopyJob3 interface contains the SetACLFlags method.
     hr = pJob->QueryInterface(__uuidof( IBackgroundCopyJob3 ), (void**)&pJob3;);
     if (S_OK == hr)
     {
          pJob->Release(); //No longer need the IBackgoundCopyJob interface pointer.

          //Copy the group and DACL information for each file.
          hr = pJob3->SetACLFlags(BG_COPY_FILE_GROUP | BG_COPY_FILE_DACL);
          if (FAILED(hr))
          {
               //Handle error.
          }

          ... //Add one or more files and resume the job.
          pJob3->Resume();

          //When done, release the interface pointer.
          pJob3->Release();
     }
     else
     {
          //Handle error. QueryInterface will return E_NOINTERFACE if the version of BITS
          //running on the computer is less than BITS 2.0.
     }

要求

另请参阅

IBackgroundCopyJob3

IBackgroundCopyJob3：：GetFileACLFlags