Metodo IBackgroundCopyJob3::SetFileACLFlags (bits2_0.h)

Specifica le informazioni sul proprietario e sull'elenco di controllo di accesso da gestire quando si usa SMB per scaricare o caricare un file.

Sintassi

HRESULT SetFileACLFlags(
  [in] DWORD Flags
);

Parametri

[in] Flags

Flag che identificano le informazioni sul proprietario e sull'elenco di controllo di accesso da mantenere durante il trasferimento di un file tramite SMB. Le chiamate successive a questo metodo sovrascrivono i flag precedenti. Specificare 0 per rimuovere i flag dal processo. È possibile specificare qualsiasi combinazione dei flag seguenti.

Valore restituito

Questo metodo restituisce i valori HRESULT seguenti, nonché altri.

Commenti

Questi flag si applicano ai nomi di file remoti che specificano il protocollo SMB. BITS ignora i flag per i trasferimenti HTTP.

BITS propaga i timestamp e gli attributi dei file (non attributi estesi) per i file SMB.

BITS applica le informazioni di proprietario e ACL al file al momento del completamento del trasferimento del file, non quando crea il file di trasferimento temporaneo. BITS non specifica un descrittore di sicurezza quando crea il file di trasferimento temporaneo (il file eredita le informazioni ACL dalla directory di destinazione). Se i dati trasferiti sono sensibili, l'applicazione deve specificare un elenco di controllo di accesso appropriato nella directory di destinazione per impedire l'accesso non autorizzato.

Per assicurarsi che le informazioni di proprietario e ACL appropriate siano impostate su tutti i file del processo, chiamare questo metodo dopo aver creato il processo e prima di chiamare il metodo IBackgroundCopyJob::Resume . In caso contrario, i file trasferiti prima dell'impostazione dei flag non conterranno le informazioni appropriate sul proprietario e sull'elenco di controllo di accesso.

Questo metodo viene modellato dopo il comando DOS di XCopy.

Le informazioni sul proprietario e sull'elenco di controllo di accesso non vengono mantenute se si esegue il download in un file system FAT.

Se l'utente non dispone dei privilegi per i computer locali e remoti per copiare le informazioni sul proprietario o sull'elenco di controllo di accesso, BITS inserisce il processo in uno stato di errore temporaneo e imposta il codice di errore su E_ACCESSDENIED.

Esempio

Nell'esempio seguente viene illustrato come chiamare il metodo SetFileACLFlags per specificare le informazioni sul proprietario e sull'elenco di controllo di accesso da mantenere con i file scaricati da BITS. L'esempio presuppone che la variabile IBackgroundCopyJob , pJob, sia valida, punti a un nuovo processo e sia sospesa.

     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.
     }

Requisiti

Vedi anche

IBackgroundCopyJob3

IBackgroundCopyJob3::GetFileACLFlags