`_pclose`

Article
12/02/2022

Waits for a new command processor and closes the stream on the associated pipe.

Important

This API cannot be used in applications that execute in the Windows Runtime. For more information, see CRT functions not supported in Universal Windows Platform apps.

Syntax

int _pclose(
FILE *stream
);

Parameters

stream
Return value from the previous call to _popen.

Return value

Returns the exit status of the terminating command processor, or -1 if an error occurs. The format of the return value is the same as for _cwait, except the low-order and high-order bytes are swapped. If stream is NULL, _pclose sets errno to EINVAL and returns -1.

For information about these and other error codes, see errno, _doserrno, _sys_errlist, and _sys_nerr.

Remarks

The _pclose function looks up the process ID of the command processor (Cmd.exe) started by the associated _popen call, executes a _cwait call on the new command processor, and closes the stream on the associated pipe.

By default, this function's global state is scoped to the application. To change this behavior, see Global state in the CRT.

Requirements

Routine	Required header
`_pclose`	<stdio.h>

For more compatibility information, see Compatibility.

Libraries

All versions of the C run-time libraries.