DisconnectNamedPipe-Funktion (namedpipeapi.h)
Trennt das Serverende einer Named Pipe instance von einem Clientprozess.
Syntax
BOOL DisconnectNamedPipe(
[in] HANDLE hNamedPipe
);
Parameter
[in] hNamedPipe
Ein Handle für eine instance einer benannten Pipe. Dieses Handle muss von der CreateNamedPipe-Funktion erstellt werden.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Wenn das Clientende der Named Pipe geöffnet ist, erzwingt die DisconnectNamedPipe-Funktion das Ende der Named Pipe. Der Client erhält einen Fehler, wenn er das nächste Mal versucht, auf die Pipe zuzugreifen. Ein Client, der von DisconnectNamedPipe erzwungen wird, muss weiterhin die CloseHandle-Funktion verwenden, um das Ende der Pipe zu schließen.
Die Pipe ist vorhanden, solange ein Server- oder Clientprozess über ein offenes Handle für die Pipe verfügt.
Wenn der Serverprozess eine Pipe instance trennt, werden alle ungelesenen Daten in der Pipe verworfen. Vor dem Trennen kann der Server sicherstellen, dass keine Daten verloren gehen, indem er die FlushFileBuffers-Funktion aufruft , die erst zurückgegeben wird, wenn der Clientprozess alle Daten gelesen hat.
Der Serverprozess muss DisconnectNamedPipe aufrufen, um ein Pipehandle vom vorherigen Client zu trennen, bevor das Handle mithilfe der ConnectNamedPipe-Funktion mit einem anderen Client verbunden werden kann.
Windows 10 Version 1709: Pipes werden nur innerhalb eines App-Containers unterstützt, d. h. von einem UWP-Prozess zu einem anderen UWP-Prozess, der Teil derselben App ist. Außerdem müssen Named Pipes die Syntax \\.\pipe\LOCAL\ für den Pipenamen verwenden.
Beispiele
Ein Beispiel finden Sie unter Multithreaded Pipe Server.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | namedpipeapi.h |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |