Fungsi DisconnectNamedPipe (namedpipeapi.h)

Artikel
02/29/2024

Memutuskan sambungan akhir server dari instans pipa bernama dari proses klien.

Sintaks

BOOL DisconnectNamedPipe(
  [in] HANDLE hNamedPipe
);

Parameter

[in] hNamedPipe

Handel ke instans pipa bernama. Handel ini harus dibuat oleh fungsi CreateNamedPipe .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Jika akhir klien dari pipa bernama terbuka, fungsi DisconnectNamedPipe memaksa akhir pipa bernama ditutup. Klien menerima kesalahan saat berikutnya mencoba mengakses pipa. Klien yang dipaksa keluar dari pipa oleh DisconnectNamedPipe masih harus menggunakan fungsi CloseHandle untuk menutup ujung pipanya.

Pipa ada selama proses server atau klien memiliki handel terbuka ke pipa.

Ketika proses server memutuskan instans pipa, data yang belum dibaca dalam pipa akan dibuang. Sebelum memutuskan sambungan, server dapat memastikan data tidak hilang dengan memanggil fungsi FlushFileBuffers , yang tidak kembali sampai proses klien membaca semua data.

Proses server harus memanggil DisconnectNamedPipe untuk memutuskan sambungan handel pipa dari klien sebelumnya sebelum handel dapat disambungkan ke klien lain dengan menggunakan fungsi ConnectNamedPipe .

Windows 10, versi 1709: Pipa hanya didukung dalam kontainer aplikasi; yaitu, dari satu proses UWP ke proses UWP lain yang merupakan bagian dari aplikasi yang sama. Selain itu, pipa bernama harus menggunakan sintaks \\.\pipe\LOCAL\ untuk nama pipa.

Contoh

Misalnya, lihat Multithreaded Pipe Server.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	namedpipeapi.h
Pustaka	Kernel32.lib
DLL	Kernel32.dll