Fungsi DisconnectNamedPipe (namedpipeapi.h)
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 |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk