_pclose

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at _pclose.

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

System_CAPS_ICON_important.jpg Important

This API cannot be used in applications that execute in the Windows Runtime. For more information, see CRT functions not supported with /ZW.

  
      int _pclose(  
FILE *stream   
);  

Parameters

stream
Return value from the previous call to _popen.

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 that 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 _doserrno, errno, _sys_errlist, and _sys_nerr.

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.

RoutineRequired header
_pclose<stdio.h>

For more compatibility information, see Compatibility.

All versions of the C run-time libraries.

Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.

Process and Environment Control
_pipe
_popen, _wpopen

Show: