WindowsIdentity.RunImpersonated Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Nome | Descrição |
|---|---|
| RunImpersonated(SafeAccessTokenHandle, Action) |
Executa a ação especificada como identidade Windows imitada. Em vez de usar uma chamada de método personificada e executar a sua função em WindowsImpersonationContext, pode usar RunImpersonated(SafeAccessTokenHandle, Action) e fornecer a sua função diretamente como parâmetro. |
| RunImpersonated<T>(SafeAccessTokenHandle, Func<T>) |
Executa a função especificada como identidade Windows personificada. Em vez de usar uma chamada de método personificada e executar a sua função em WindowsImpersonationContext, pode usar RunImpersonated(SafeAccessTokenHandle, Action) e fornecer a sua função diretamente como parâmetro. |
RunImpersonated(SafeAccessTokenHandle, Action)
Executa a ação especificada como identidade Windows imitada. Em vez de usar uma chamada de método personificada e executar a sua função em WindowsImpersonationContext, pode usar RunImpersonated(SafeAccessTokenHandle, Action) e fornecer a sua função diretamente como parâmetro.
public:
static void RunImpersonated(Microsoft::Win32::SafeHandles::SafeAccessTokenHandle ^ safeAccessTokenHandle, Action ^ action);
public static void RunImpersonated(Microsoft.Win32.SafeHandles.SafeAccessTokenHandle safeAccessTokenHandle, Action action);
static member RunImpersonated : Microsoft.Win32.SafeHandles.SafeAccessTokenHandle * Action -> unit
Public Shared Sub RunImpersonated (safeAccessTokenHandle As SafeAccessTokenHandle, action As Action)
Parâmetros
- safeAccessTokenHandle
- SafeAccessTokenHandle
O SafeAccessTokenHandle da identidade Windows personificada.
- action
- Action
O Sistema.Ação para correr.
Exemplos
O exemplo seguinte demonstra o uso da WindowsIdentity classe para se fazer passar por um utilizador.
Warning
Este exemplo pede ao utilizador que insira uma palavra-passe no ecrã da consola. A palavra-passe será visível no ecrã, porque a janela da consola não suporta entrada mascarada nativamente.
// The following example demonstrates the use of the WindowsIdentity class to impersonate a user.
// IMPORTANT NOTE:
// This sample asks the user to enter a password on the console screen.
// The password will be visible on the screen, because the console window
// does not support masked input natively.
using System;
using System.Runtime.InteropServices;
using System.Security;
using System.Security.Principal;
using Microsoft.Win32.SafeHandles;
public class ImpersonationDemo
{
[DllImport("advapi32.dll", SetLastError = true, CharSet = CharSet.Unicode)]
public static extern bool LogonUser(String lpszUsername, String lpszDomain, String lpszPassword,
int dwLogonType, int dwLogonProvider, out SafeAccessTokenHandle phToken);
public static void Main()
{
// Get the user token for the specified user, domain, and password using the
// unmanaged LogonUser method.
// The local machine name can be used for the domain name to impersonate a user on this machine.
Console.Write("Enter the name of the domain on which to log on: ");
string domainName = Console.ReadLine();
Console.Write("Enter the login of a user on {0} that you wish to impersonate: ", domainName);
string userName = Console.ReadLine();
Console.Write("Enter the password for {0}: ", userName);
const int LOGON32_PROVIDER_DEFAULT = 0;
//This parameter causes LogonUser to create a primary token.
const int LOGON32_LOGON_INTERACTIVE = 2;
// Call LogonUser to obtain a handle to an access token.
SafeAccessTokenHandle safeAccessTokenHandle;
bool returnValue = LogonUser(userName, domainName, Console.ReadLine(),
LOGON32_LOGON_INTERACTIVE, LOGON32_PROVIDER_DEFAULT,
out safeAccessTokenHandle);
if (false == returnValue)
{
int ret = Marshal.GetLastWin32Error();
Console.WriteLine("LogonUser failed with error code : {0}", ret);
throw new System.ComponentModel.Win32Exception(ret);
}
Console.WriteLine("Did LogonUser Succeed? " + (returnValue ? "Yes" : "No"));
// Check the identity.
Console.WriteLine("Before impersonation: " + WindowsIdentity.GetCurrent().Name);
// Note: if you want to run as unimpersonated, pass
// 'SafeAccessTokenHandle.InvalidHandle' instead of variable 'safeAccessTokenHandle'
WindowsIdentity.RunImpersonated(
safeAccessTokenHandle,
// User action
() =>
{
// Check the identity.
Console.WriteLine("During impersonation: " + WindowsIdentity.GetCurrent().Name);
}
);
// Check the identity again.
Console.WriteLine("After impersonation: " + WindowsIdentity.GetCurrent().Name);
}
}
Observações
Note
Este método pode ser usado de forma fiável com o padrão async/await, ao contrário Impersonatede . Num método assíncrono, a sobrecarga genérica deste método pode ser usada com um argumento delegado assíncrono para que a tarefa resultante possa ser aguardada.
Aplica-se a
RunImpersonated<T>(SafeAccessTokenHandle, Func<T>)
Executa a função especificada como identidade Windows personificada. Em vez de usar uma chamada de método personificada e executar a sua função em WindowsImpersonationContext, pode usar RunImpersonated(SafeAccessTokenHandle, Action) e fornecer a sua função diretamente como parâmetro.
public:
generic <typename T>
static T RunImpersonated(Microsoft::Win32::SafeHandles::SafeAccessTokenHandle ^ safeAccessTokenHandle, Func<T> ^ func);
public static T RunImpersonated<T>(Microsoft.Win32.SafeHandles.SafeAccessTokenHandle safeAccessTokenHandle, Func<T> func);
static member RunImpersonated : Microsoft.Win32.SafeHandles.SafeAccessTokenHandle * Func<'T> -> 'T
Public Shared Function RunImpersonated(Of T) (safeAccessTokenHandle As SafeAccessTokenHandle, func As Func(Of T)) As T
Parâmetros de Tipo Genérico
- T
O tipo de objeto usado e devolvido pela função.
Parâmetros
- safeAccessTokenHandle
- SafeAccessTokenHandle
O SafeAccessTokenHandle da identidade Windows personificada.
- func
- Func<T>
O System.Func para correr.
Devoluções
O resultado da função.
Exemplos
O exemplo seguinte demonstra o uso da WindowsIdentity classe para se fazer passar por um utilizador.
Warning
Este exemplo pede ao utilizador que insira uma palavra-passe no ecrã da consola. A palavra-passe será visível no ecrã, porque a janela da consola não suporta entrada mascarada nativamente.
// The following example demonstrates the use of the WindowsIdentity class to impersonate a user.
// IMPORTANT NOTE:
// This sample asks the user to enter a password on the console screen.
// The password will be visible on the screen, because the console window
// does not support masked input natively.
using System;
using System.Runtime.InteropServices;
using System.Security;
using System.Security.Principal;
using Microsoft.Win32.SafeHandles;
public class ImpersonationDemo
{
[DllImport("advapi32.dll", SetLastError = true, CharSet = CharSet.Unicode)]
public static extern bool LogonUser(String lpszUsername, String lpszDomain, String lpszPassword,
int dwLogonType, int dwLogonProvider, out SafeAccessTokenHandle phToken);
public static void Main()
{
// Get the user token for the specified user, domain, and password using the
// unmanaged LogonUser method.
// The local machine name can be used for the domain name to impersonate a user on this machine.
Console.Write("Enter the name of the domain on which to log on: ");
string domainName = Console.ReadLine();
Console.Write("Enter the login of a user on {0} that you wish to impersonate: ", domainName);
string userName = Console.ReadLine();
Console.Write("Enter the password for {0}: ", userName);
const int LOGON32_PROVIDER_DEFAULT = 0;
//This parameter causes LogonUser to create a primary token.
const int LOGON32_LOGON_INTERACTIVE = 2;
// Call LogonUser to obtain a handle to an access token.
SafeAccessTokenHandle safeAccessTokenHandle;
bool returnValue = LogonUser(userName, domainName, Console.ReadLine(),
LOGON32_LOGON_INTERACTIVE, LOGON32_PROVIDER_DEFAULT,
out safeAccessTokenHandle);
if (false == returnValue)
{
int ret = Marshal.GetLastWin32Error();
Console.WriteLine("LogonUser failed with error code : {0}", ret);
throw new System.ComponentModel.Win32Exception(ret);
}
Console.WriteLine("Did LogonUser Succeed? " + (returnValue ? "Yes" : "No"));
// Check the identity.
Console.WriteLine("Before impersonation: " + WindowsIdentity.GetCurrent().Name);
// Note: if you want to run as unimpersonated, pass
// 'SafeAccessTokenHandle.InvalidHandle' instead of variable 'safeAccessTokenHandle'
WindowsIdentity.RunImpersonated(
safeAccessTokenHandle,
// User action
() =>
{
// Check the identity.
Console.WriteLine("During impersonation: " + WindowsIdentity.GetCurrent().Name);
}
);
// Check the identity again.
Console.WriteLine("After impersonation: " + WindowsIdentity.GetCurrent().Name);
}
}
Observações
Note
Este método pode ser usado de forma fiável com o padrão async/await, ao contrário Impersonatede . Num método assíncrono, este método pode ser usado com um argumento delegado assíncrono para que a tarefa resultante possa ser aguardada.