SemaphoreAcl.TryOpenExisting(String, SemaphoreRights, Semaphore) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Пытается открыть указанный именованный семафор, если он уже существует, применяет необходимые права доступа и возвращает значение, указывающее, успешно ли выполнена операция.
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
Параметры
- name
- String
Имя открываемого семафора. Если он имеет префикс "Global", он относится к семафору на уровне компьютера. Если он имеет префикс "Local" или не имеет префикса, он ссылается на семафор для всего сеанса. Префикс и имя чувствительны к регистру.
- rights
- SemaphoreRights
Требуемые права доступа, применяемые к возвращаемой семафору.
- result
- Semaphore
Когда этот метод возвращает true
, содержит объект , который представляет именованный семафор, если вызов выполнен успешно, или null
иным образом. Этот параметр обрабатывается как неинициализированный.
Возвращаемое значение
Значение true
, если именованный семафор был успешно открыт; в противном случае — значение false
.
Исключения
name
имеет значение null
.
Параметр name
равен пустой строке.
Произошла ошибка Win32.
Именованный семафор существует, но у пользователя нет прав доступа, необходимых для его использования.