Metodo IBitsTokenOptions::GetHelperTokenFlags (bits4_0.h)

Articolo
02/23/2024

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

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

Condividi tramite