На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

CreatePipe



The CreatePipe function creates an anonymous pipe, and returns handles to the read and write ends of the pipe.

BOOL CreatePipe(

PHANDLE hReadPipe, // address of variable for read handle
PHANDLE hWritePipe, // address of variable for write handle
LPSECURITY_ATTRIBUTES lpPipeAttributes, // pointer to security attributes
DWORD nSize // number of bytes reserved for pipe
);


Parameters

hReadPipe

Points to the variable that receives the read handle for the pipe.

hWritePipe

Points to the variable that receives the write handle for the pipe.

lpPipeAttributes

Pointer to a SECURITY_ATTRIBUTES structure that determines whether the returned handle can be inherited by child processes. If lpPipeAttributes is NULL, the handle cannot be inherited.

Windows NT: The lpSecurityDescriptor member of the structure specifies a security descriptor for the new pipe. If lpPipeAttributes is NULL, the pipe gets a default security descriptor.
Windows 95: The lpSecurityDescriptor member of the structure is ignored.

nSize

Specifies the buffer size for the pipe. The size is only a suggestion; the system uses the value to calculate an appropriate buffering mechanism. If this parameter is zero, the system uses the default buffer size.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

CreatePipe creates the pipe, assigning the specified pipe size to the storage buffer. CreatePipe also creates handles that the process uses to read from and write to the buffer in subsequent calls to the ReadFile and WriteFile functions.
To read from the pipe, a process uses the read handle in a call to the ReadFile function. ReadFile returns when one of the following is true: a write operation completes on the write end of the pipe, the number of bytes requested has been read, or an error occurs.

When a process uses WriteFile to write to an anonymous pipe, the write operation is not completed until all bytes are written. If the pipe buffer is full before all bytes are written, WriteFile does not return until another process or thread uses ReadFile to make more buffer space available.

See Also

ReadFile, SECURITY_ATTRIBUTES, WriteFile


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

CreatePipe



Функция CreatePipe создает анонимную трубу и возвращает ручкам на чтение и концы записи трубы.

BOOL CreatePipe(

PHANDLE hReadPipe, // АДРЕС переменной для ручки чтения PHANDLE hWritePipe, // адрес переменной для писать ручки LPSECURITY_ATTRIBUTES lpPipeAttributes, // указатель в безопасность приписывает количество DWORD nSize // байтов резервировался для трубы
);


Параметры

hReadPipe

Точки на переменную, которые получают ручку чтения для трубы.

hWritePipe

Точки на переменную, которые получают писать ручку для трубы.

lpPipeAttributes

Указатель в структуру SECURITY_ATTRIBUTES, которая определяет может возвращанная ручка быть унаследована процессами ребенка. Если lpPipeAttributes НЕДЕЙСТВИТЕЛЕН, ручка не может быть унаследована.

Окно NT: член lpSecurityDescriptor структуры определяет дескриптор безопасности для новой трубы. Если lpPipeAttributes НЕДЕЙСТВИТЕЛЕН, труба получает встроенный дескриптор безопасности.
Окно 95: член lpSecurityDescriptor структуры проигнорирован.

nSize

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



Обратные Величины

Если функция добивается успеха, обратная величина ненулевая.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

CreatePipe СОЗДАЕТ трубу, назначающую определенный размер трубы в буфер памяти. CreatePipe ТАКЖЕ создает ручки, которые процесс использует, чтобы читаться из и записываться в буфер на последующих вызовах в ReadFile и функции WriteFile.
Чтобы читаться из трубы, процесс использует ручку чтения на вызове в функцию ReadFile. ReadFile ВОЗВРАЩАЕТСЯ когда одно из следующего - истина: записывать операция завершается в записывать конце трубы, количество запрошенных байтов прочитано, или ошибка происходит.

Когда процесс использует WriteFile, чтобы записываться в анонимную трубу, записывать операция не завершена пока все байты не будут записаны. Если буфер трубы полный прежде, чем все байты будут записаны, WriteFile не возвращается пока другой процесс или резьба не используют ReadFile, чтобы делать более буферным космическим доступным.

Смотри Также

ReadFile, SECURITY_ATTRIBUTES, WriteFile


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz