EventWaitHandleAcl.TryOpenExisting Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Пытается открыть указанный именованный дескриптор ожидания события, если он уже существует, применяет требуемые права доступа и возвращает значение, указывающее, выполнена ли операция успешно.
public:
static bool TryOpenExisting(System::String ^ name, System::Security::AccessControl::EventWaitHandleRights rights, [Runtime::InteropServices::Out] System::Threading::EventWaitHandle ^ % result);
public static bool TryOpenExisting(string name, System.Security.AccessControl.EventWaitHandleRights rights, out System.Threading.EventWaitHandle? result);
public static bool TryOpenExisting(string name, System.Security.AccessControl.EventWaitHandleRights rights, out System.Threading.EventWaitHandle result);
static member TryOpenExisting : string * System.Security.AccessControl.EventWaitHandleRights * EventWaitHandle -> bool
Public Shared Function TryOpenExisting (name As String, rights As EventWaitHandleRights, ByRef result As EventWaitHandle) As Boolean
Параметры
- name
- String
Имя открываемого дескриптора ожидания события. Если оно имеет префикс "Global", оно ссылается на дескриптор ожидания событий на уровне компьютера. Если он имеет префикс "Local" или не имеет префикса, он ссылается на дескриптор ожидания событий на уровне сеанса. Префикс и имя чувствительны к регистру.
- rights
- EventWaitHandleRights
Требуемые права доступа, применимые к возвращаемой дескриптору ожидания события.
- result
- EventWaitHandle
При возврате trueэтого метода содержит объект, представляющий именованный дескриптор ожидания события, если вызов выполнен успешно или в null противном случае. Этот параметр рассматривается как неинициализированный.
Возвращаемое значение
true Значение , если именованный дескриптор ожидания события был успешно открыт; falseв противном случае .
Исключения
name равен null
name — пустая строка.
Произошла ошибка Win32.
Дескриптор ожидания именованного события существует, но у пользователя нет доступа к безопасности, необходимого для его использования.