NamedPipeServerStreamAcl.Create Метод

  • Ссылка

Определение

Пространство имен:
System.IO.Pipes
Сборка:
System.IO.Pipes.AccessControl.dll

Создает новый экземпляр класса NamedPipeServerStream с заданным именем канала, направлением канала, максимальным количеством экземпляров сервера, режимом передачи, параметрами канала, рекомендуемыми размерами входного и выходного буферов, режимом безопасности канала, режимом наследования и правами доступа к каналу.

public static System.IO.Pipes.NamedPipeServerStream Create (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances, System.IO.Pipes.PipeTransmissionMode transmissionMode, System.IO.Pipes.PipeOptions options, int inBufferSize, int outBufferSize, System.IO.Pipes.PipeSecurity? pipeSecurity, System.IO.HandleInheritability inheritability = System.IO.HandleInheritability.None, System.IO.Pipes.PipeAccessRights additionalAccessRights = (System.IO.Pipes.PipeAccessRights) 0);
static member Create : string * System.IO.Pipes.PipeDirection * int * System.IO.Pipes.PipeTransmissionMode * System.IO.Pipes.PipeOptions * int * int * System.IO.Pipes.PipeSecurity * System.IO.HandleInheritability * System.IO.Pipes.PipeAccessRights -> System.IO.Pipes.NamedPipeServerStream
Public Shared Function Create (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer, transmissionMode As PipeTransmissionMode, options As PipeOptions, inBufferSize As Integer, outBufferSize As Integer, pipeSecurity As PipeSecurity, Optional inheritability As HandleInheritability = System.IO.HandleInheritability.None, Optional additionalAccessRights As PipeAccessRights = (System.IO.Pipes.PipeAccessRights) 0) As NamedPipeServerStream

Параметры

pipeName
String

Имя канала.

direction
PipeDirection

Одно из значений перечисления, определяющее направление канала.

maxNumberOfServerInstances
Int32

Максимальное число экземпляров сервера с одинаковыми именами. Для этого значения можно передать MaxAllowedServerInstances.

transmissionMode
PipeTransmissionMode

Одно из значений перечисления, определяющее режим передачи канала.

options
PipeOptions

Одно из значений перечисления, определяющее способ открытия или создания канала.

inBufferSize
Int32

Размер входного буфера.

outBufferSize
Int32

Размер выходного буфера.

pipeSecurity
PipeSecurity

Объект, определяющий правила управления доступом и аудита безопасности для канала.

inheritability
HandleInheritability

Одно из значений перечисления, определяющее, может ли базовый дескриптор наследоваться дочерними процессами.

additionalAccessRights
PipeAccessRights

Одно из значений перечисления, задающее права доступа для канала.

Возвращаемое значение

NamedPipeServerStream

Новый экземпляр потока сервера именованного канала.

Исключения

ArgumentNullException

pipeName имеет значение null.

ArgumentException

Параметр pipeName пуст.

IOException

options имеет значение None.

ArgumentOutOfRangeException

options содержит недопустимый флаг.

-или-

Значение параметра inBufferSize или outBufferSize меньше нуля.

-или-

maxNumberOfServerInstances не является допустимым числом: значение должно быть равно или больше 1 либо равно или меньше 254. Либо оно должно соответствовать значению MaxAllowedServerInstances.

-или-

inheritability содержит недопустимое значение перечисления.

-или-

Для pipeName задано значение anonymous, которое является зарезервированным.

Комментарии

Если options содержит CurrentUserOnly, переданный pipeSecurity объект игнорируется, а возвращенный NamedPipeServerStream объект создается с помощью пользовательского PipeSecurity экземпляра, назначенного текущему пользователю Windows в качестве его единственного владельца с полным контролем над каналом.

Применяется к