GetCurrentThreadEffectiveToken 函式 (processthreadsapi.h)

擷取虛擬句柄,您可以用做為簡短方式來參考目前作用於線程的令牌,如果線程存在,則為線程令牌,否則為進程令牌。

Syntax

HANDLE GetCurrentThreadEffectiveToken();

傳回值

虛擬句柄,可用來做為簡短方式來參考目前作用於線程的令牌。

備註

虛擬句柄是特殊的常數,可作為目前線程的有效令牌。 每當需要令牌句柄時,呼叫線程可以使用虛擬句柄來指定該線程的有效令牌。 子進程不會繼承虛擬句柄。

從 Windows 8 開始,此虛擬句柄只有TOKEN_QUERY和TOKEN_QUERY_SOURCE訪問許可權。

DuplicateHandle 函式或 DuplicateToken 函式無法複製虛擬句柄。

當您不再需要虛擬句柄時,您不需要關閉虛擬句柄。 如果您使用虛擬句柄呼叫 CloseHandle 函式,函式就不會有任何作用。

規格需求

需求
最低支援的用戶端 Windows 8 [傳統型應用程式 UWP 應用程式]
最低支援的伺服器 Windows Server 2012 [傳統型應用程式 UWP 應用程式]
目標平台 Windows
標頭 processthreadsapi.h

另請參閱

Access-Token 對象的訪問許可權

GetCurrentProcessToken

GetCurrentThreadToken