SemaphoreAcl.Create(Int32, Int32, String, Boolean, SemaphoreSecurity) Método

Definición

Espacio de nombres:

System.Threading

Ensamblado:

System.Threading.AccessControl.dll

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

public:
 static System::Threading::Semaphore ^ Create(int initialCount, int maximumCount, System::String ^ name, [Runtime::InteropServices::Out] bool % createdNew, System::Security::AccessControl::SemaphoreSecurity ^ semaphoreSecurity);

public static System.Threading.Semaphore Create (int initialCount, int maximumCount, string? name, out bool createdNew, System.Security.AccessControl.SemaphoreSecurity? semaphoreSecurity);

static member Create : int * int * string * bool * System.Security.AccessControl.SemaphoreSecurity -> System.Threading.Semaphore

Public Shared Function Create (initialCount As Integer, maximumCount As Integer, name As String, ByRef createdNew As Boolean, semaphoreSecurity As SemaphoreSecurity) As Semaphore

Parámetros

initialCount

Int32

Número inicial de solicitudes para el semáforo que se puede satisfacer simultáneamente.

maximumCount

Int32

Número máximo de solicitudes para el semáforo que se puede satisfacer simultáneamente.

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 semáforo 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 semáforo del sistema, o bien se establece en false si se encuentra un semáforo del sistema existente con ese nombre. Este parámetro se pasa sin inicializar.

semaphoreSecurity

SemaphoreSecurity

Seguridad del control de acceso de semáforo opcional que se va a aplicar.

Devoluciones

Semaphore

Objeto que representa un semáforo del sistema, si tiene nombre, o un semáforo local, si no tiene nombre.

Excepciones

ArgumentOutOfRangeException

initialCount es un número negativo. O bien

maximumCount no es un número positivo.

ArgumentException

initialCount es mayor que maximumCount.

O bien

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

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.

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 semáforo con nombre no está restringido al usuario que lo creó. Es posible que otros usuarios puedan abrir y usar el semáforo, incluida la interferencia con el semáforo al adquirir el semáforo varias veces y no liberarlo. Para restringir el acceso a usuarios específicos, puede pasar un SemaphoreSecurity elemento al crear el semáforo con nombre. Evite usar semáforos con nombre sin restricciones de acceso en sistemas que podrían tener usuarios que no son de confianza ejecutando código.