DisconnectNamedPipe-Funktion (namedpipeapi.h)

Artikel
02/29/2024

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