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 в качестве его единственного владельца с полным контролем над каналом.