_pclose

Ожидает новый обработчик команд и закрывает поток по связанному каналу.

Внимание

Этот API нельзя использовать в приложениях, выполняемых в среде выполнения Windows. Дополнительные сведения: Функции CRT, которые не поддерживаются в приложениях универсальной платформы Windows.

Синтаксис

int _pclose(
FILE *stream
);

Параметры

stream
Возвращаемое значение из предыдущего вызова функции _popen.

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

Возвращает состояние выхода завершающего обработчика команд или -1 при возникновении ошибки. Формат возвращаемого значения совпадает с _cwaitформатом, кроме байтов с низким порядком и высоким порядком. Если поток имеет значениеNULL, _pclose задает EINVAL errno и возвращает значение -1.

Сведения об этих и других кодах ошибок см. в разделе errno, _doserrno_sys_errlistи _sys_nerr.

Замечания

Функция _pclose ищет идентификатор процесса обработчика команд (Cmd.exe), запущенного связанным _popen вызовом, выполняет _cwait вызов нового обработчика команд и закрывает поток в связанном канале.

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Требования

Маршрут	Обязательный заголовок
_pclose	<stdio.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

Библиотеки

Все версии библиотек времени выполнения языка C.

См. также

Управление процессами и средой
_pipe
_popen, _wpopen