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);
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.
Дескриптор ожидания именованного события существует, но у пользователя нет доступа к безопасности, необходимого для его использования.