Documentation of use of ConPTY together with STARTF_USESTDHANDLES is lacking. #6439

Open
opened 2026-01-31 00:38:42 +00:00 by claunia · 2 comments
Owner

Originally created by @grubba on GitHub (Feb 14, 2020).

All existing documentation of ConPTY seem to only mention the case where stdin, stdout and stderr are all to be connected to the pty and no STARTF_USESTDHANDLES. The only mention that the proper value to have in StartupInfo.hStdInput et al when STARTF_USESTDHANDLES is active is NULL is indirectly in the documentation for GetStdHandle().

Using STARTF_USESTDHANDLES is useful if you want to keep stdout and stderr separate or want to redirect one of them to eg a file.

An explicit mention in conjunction with STARTUPINFOA and/or PROC_THREAD_ATTRIBUTE_PSEUDOCONSOLE would be appreciated.

Thanks.

Originally created by @grubba on GitHub (Feb 14, 2020). <!-- Briefly describe which document needs to be corrected and why. --> All existing documentation of ConPTY seem to only mention the case where stdin, stdout and stderr are all to be connected to the pty and no STARTF_USESTDHANDLES. The only mention that the proper value to have in StartupInfo.hStdInput et al when STARTF_USESTDHANDLES is active is NULL is indirectly in the documentation for GetStdHandle(). Using STARTF_USESTDHANDLES is useful if you want to keep stdout and stderr separate or want to redirect one of them to eg a file. An explicit mention in conjunction with STARTUPINFOA and/or PROC_THREAD_ATTRIBUTE_PSEUDOCONSOLE would be appreciated. Thanks.
claunia added the Help WantedArea-ServerProduct-ConptyIssue-Docs labels 2026-01-31 00:38:42 +00:00
Author
Owner

@DHowett-MSFT commented on GitHub (Feb 21, 2020):

Thanks for the request! I'll mark this one for documentation on the console backlog.

@DHowett-MSFT commented on GitHub (Feb 21, 2020): Thanks for the request! I'll mark this one for documentation on the console backlog.
Author
Owner

@nyitnyitnet commented on GitHub (Apr 3, 2020):

Çoment

@nyitnyitnet commented on GitHub (Apr 3, 2020): Çoment
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/terminal#6439