EventWaitHandleAcl.Create Método

Definición

Espacio de nombres:

System.Threading

Ensamblado:

System.Threading.AccessControl.dll

Paquete:

System.Threading.AccessControl v9.0.0-preview.3.24172.9

Source:

EventWaitHandleAcl.cs

Obtiene o crea una instancia de EventWaitHandle, lo que permite especificar opcionalmente una instancia de EventWaitHandleSecurity para establecerla durante la creación del evento.

public:
 static System::Threading::EventWaitHandle ^ Create(bool initialState, System::Threading::EventResetMode mode, System::String ^ name, [Runtime::InteropServices::Out] bool % createdNew, System::Security::AccessControl::EventWaitHandleSecurity ^ eventSecurity);

public static System.Threading.EventWaitHandle Create (bool initialState, System.Threading.EventResetMode mode, string? name, out bool createdNew, System.Security.AccessControl.EventWaitHandleSecurity? eventSecurity);

static member Create : bool * System.Threading.EventResetMode * string * bool * System.Security.AccessControl.EventWaitHandleSecurity -> System.Threading.EventWaitHandle

Public Shared Function Create (initialState As Boolean, mode As EventResetMode, name As String, ByRef createdNew As Boolean, eventSecurity As EventWaitHandleSecurity) As EventWaitHandle

Parámetros

initialState

Boolean

true para establecer el estado inicial en señalado si se crea el evento con nombre como resultado de esta llamada; false para establecerlo en no señalizado.

mode

EventResetMode

Uno de los valores de enumeración que determina si el evento se restablece automática o manualmente.

name

String

Nombre, si el objeto de sincronización se va a compartir con otros procesos; en caso contrario, null o una cadena vacía. El nombre distingue entre mayúsculas y minúsculas. El carácter de barra diagonal inversa (\) está reservado y solo se puede usar para especificar un espacio de nombres. Para obtener más información sobre los espacios de nombres, consulte la sección comentarios. Puede haber más restricciones en el nombre en función del sistema operativo. Por ejemplo, en los sistemas operativos basados en Unix, el nombre después de excluir el espacio de nombres debe ser un nombre de archivo válido.

createdNew

Boolean

Cuando este método devuelve un valor, este argumento siempre se establece en true si se crea un evento local, es decir, cuando name es null o Empty. Si name tiene un valor no vacío válido, este argumento se establece en true cuando se crea el evento del sistema, o bien se establece en false si se encuentra un evento del sistema existente con ese nombre.

eventSecurity

EventWaitHandleSecurity

Seguridad del control de acceso de Windows opcional que se va a aplicar.

Devoluciones

EventWaitHandle

Objeto que representa un controlador de espera de evento según se solicite.

Excepciones

ArgumentException

El valor de enumeración mode está fuera del intervalo válido.

O bien

Solo .NET Framework: name es mayor que MAX_PATH (260 caracteres).

ArgumentOutOfRangeException

El valor de enumeración mode está fuera del intervalo válido. En algunos casos, se produce ArgumentException en su lugar.

IOException

name no es válido. Esto puede deberse a diversos motivos, incluidas algunas restricciones que puede imponer el sistema operativo, como un prefijo desconocido o caracteres no válidos. Tenga en cuenta que el nombre y los prefijos comunes "Global\" y "Local\" distinguen mayúsculas de minúsculas.

O bien

Hubo algún otro error. La propiedad HResult puede proporcionar más información.

DirectoryNotFoundException

Solo Windows: name especificó un espacio de nombres desconocido. Consulte Nombres de objetos para obtener más información.

PathTooLongException

name es demasiado largo. Las restricciones de longitud pueden depender del sistema operativo o la configuración.

WaitHandleCannotBeOpenedException

No se puede crear un objeto de sincronización con el valor name proporcionado. Un objeto de sincronización de un tipo diferente podría tener el mismo nombre.

UnauthorizedAccessException

El evento con nombre existe, pero el usuario no tiene el acceso de seguridad deseado.

ArgumentNullException

Solo .NET Framework: la longitud de name es superior a MAX_PATH (260 caracteres).

Comentarios

name puede tener el prefijo o Global\Local\ especificar un espacio de nombres. Cuando se especifica el Global espacio de nombres, el objeto de sincronización se puede compartir con cualquier proceso del sistema. Cuando se especifica el Local espacio de nombres , que también es el valor predeterminado cuando no se especifica ningún espacio de nombres, el objeto de sincronización se puede compartir con procesos en la misma sesión. En Windows, una sesión es una sesión de inicio de sesión y los servicios normalmente se ejecutan en una sesión no interactiva diferente. En sistemas operativos similares a Unix, cada shell tiene su propia sesión. Los objetos de sincronización local de sesión pueden ser adecuados para sincronizar entre procesos con una relación primaria o secundaria en la que se ejecutan en la misma sesión. Para obtener más información sobre los nombres de objetos de sincronización en Windows, vea Nombres de objeto.

Si se proporciona un name objeto y ya existe un objeto de sincronización del tipo solicitado en el espacio de nombres, se abre el objeto de sincronización existente. Si ya existe un objeto de sincronización de un tipo diferente en el espacio de nombres , se produce una WaitHandleCannotBeOpenedException excepción . De lo contrario, se crea un nuevo objeto de sincronización.

Precaución

De forma predeterminada, un evento con nombre no está restringido al usuario que lo creó. Es posible que otros usuarios puedan abrir y usar el evento, incluida la interferencia con el evento estableciendo o restableciendolo de forma inapropiada. Para restringir el acceso a usuarios específicos, puede pasar un al EventWaitHandleSecurity crear el evento con nombre. Evite el uso de eventos con nombre sin restricciones de acceso en sistemas que podrían tener usuarios que no son de confianza que ejecuten código.