SemaphoreAcl.TryOpenExisting(String, SemaphoreRights, Semaphore) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Intenta abrir un semáforo con nombre especificado, si ya existe, aplica los derechos de acceso deseados y devuelve un valor que indica si la operación se realizó correctamente.
public:
static bool TryOpenExisting(System::String ^ name, System::Security::AccessControl::SemaphoreRights rights, [Runtime::InteropServices::Out] System::Threading::Semaphore ^ % result);
public static bool TryOpenExisting (string name, System.Security.AccessControl.SemaphoreRights rights, out System.Threading.Semaphore? result);
static member TryOpenExisting : string * System.Security.AccessControl.SemaphoreRights * Semaphore -> bool
Public Shared Function TryOpenExisting (name As String, rights As SemaphoreRights, ByRef result As Semaphore) As Boolean
Parámetros
- name
- String
Nombre del semáforo que se va a abrir. Si tiene el prefijo "Global", hace referencia a un semáforo de toda la máquina. Si tiene el prefijo "Local" o no tiene un prefijo, hace referencia a un semáforo de toda la sesión. Tanto el prefijo como el nombre distinguen mayúsculas de minúsculas.
- rights
- SemaphoreRights
Los derechos de acceso deseados que se aplicarán al semáforo devuelto.
- result
- Semaphore
Cuando este método devuelve true
, contiene un objeto que representa el semáforo con nombre si la llamada se realizó correctamente o null
de lo contrario. Este parámetro se trata como sin inicializar.
Devoluciones
true
si el semáforo con nombre se abrió correctamente; si no, false
.
Excepciones
name
es null
name
es una cadena vacía.
Error de Win32.
El semáforo con nombre existe, pero el usuario no tiene el acceso de seguridad necesario para usarlo.