Condividi tramite

Metodo IBitsTokenOptions::GetHelperTokenFlags (bits4_0.h)

  • Articolo

Restituisce i flag di utilizzo per un token associato a un processo di trasferimento BITS.

Sintassi

HRESULT GetHelperTokenFlags(
  [out] DWORD *pFlags
);

Parametri

[out] pFlags

Specifica il flag di utilizzo da restituire. Questo parametro deve essere impostato su uno dei valori seguenti:

Valore Significato
BG_TOKEN_LOCAL_FILE
0x0001
 Se questo flag viene specificato, viene usato il token helper
  • Per aprire il file locale di un processo di caricamento
  • Per creare o rinominare il file temporaneo di un processo di download
  • Per creare o rinominare il file di risposta di un processo upload-reply
BG_TOKEN_NETWORK
0x0002
 Se questo flag viene specificato, viene usato il token helper
  • Per aprire il file remoto di un caricamento OMB (Server Message Block) o di un processo di download
  • In risposta a una richiesta di richiesta di proxy o server HTTP per le credenziali NTLM o Kerberos implicite
È necessaria un'applicazione per chiamare il metodo IBackgroundCopyJob2::SetCredentials per consentire l'invio delle credenziali tramite HTTP.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Le implementazioni meno recenti richiedono efficacemente che gli utenti BITS dispongano di privilegi di amministratore per ottenere i flag token helper con questo metodo. A partire da Windows 10, versione 1607, gli utenti BITS non amministratori possono usare questo metodo per ottenere i flag di utilizzo dei token helper nei processi BITS di cui sono proprietari. Questa modifica consente agli utenti BITS non amministratori (ad esempio i servizi downloader in background in esecuzione nell'account NetworkService) di usare in modo efficace i token helper.

In particolare, l'implementazione è stata modificata per consentire agli utenti senza privilegi di amministratore di ottenere flag di token helper, purché il SID del token del thread del chiamante sia uguale al SID dell'account utente del proprietario del processo durante la chiamata IBackgroundCopyJob::QueryInterface .

Requisiti

Requisito Valore
Client minimo supportato Windows 7
Server minimo supportato Windows Server 2008 R2
Piattaforma di destinazione Windows
Intestazione bits4_0.h
Componente ridistribuibile Windows Management Framework in Windows Vista con SP1, Windows Vista con SP2 e Windows Server 2008 con SP2

Vedi anche

IBitsTokenOptions