Fungsi DdeSetQualityOfService (dde.h)

Artikel
02/29/2024

Menentukan kualitas layanan (QOS) yang diinginkan aplikasi Dynamic Data Exchange (DDE) mentah untuk percakapan DDE di masa mendatang yang dimulainya. QOS yang ditentukan berlaku untuk percakapan apa pun yang dimulai saat pengaturan tersebut diterapkan. Kualitas layanan percakapan DDE berlangsung selama durasi percakapan; panggilan ke fungsi DdeSetQualityOfService selama percakapan tidak memengaruhi QOS percakapan tersebut.

Sintaks

BOOL DdeSetQualityOfService(
  [in]  HWND                              hwndClient,
  [in]  const SECURITY_QUALITY_OF_SERVICE *pqosNew,
  [out] PSECURITY_QUALITY_OF_SERVICE      pqosPrev
);

Parameter

[in] hwndClient

Jenis: HWND

Handel ke jendela klien DDE yang menentukan sumber pesan WM_DDE_INITIATE yang akan dikirim klien untuk memulai percakapan DDE.

[in] pqosNew

Jenis: const SECURITY_QUALITY_OF_SERVICE*

Penunjuk ke struktur SECURITY_QUALITY_OF_SERVICE untuk kualitas nilai layanan yang diinginkan.

[out] pqosPrev

Jenis: PSECURITY_QUALITY_OF_SERVICE

Penunjuk ke struktur SECURITY_QUALITY_OF_SERVICE yang menerima kualitas nilai layanan sebelumnya yang terkait dengan jendela yang diidentifikasi oleh hwndClient.

Parameter ini bersifat opsional. Jika aplikasi tidak tertarik dengan nilai QOS hwndClient sebelumnya, aplikasi harus mengatur pqosPrev ke NULL.

Mengembalikan nilai

Jenis: BOOL

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 kualitas layanan belum ditentukan untuk jendela klien, hwndClient, sebelum mengirim WM_DDE_INITIATE dengan wParam diatur ke hwndClient, sistem menggunakan kualitas default nilai layanan berikut untuk jendela klien:

{ 
   Length = sizeof(SECURITY_QUALITY_OF_SERVICE); 
   ImpersonationLevel = SecurityImpersonation; 
   ContextTrackingMode = SECURITY_STATIC_TRACKING; 
   EffectiveOnly = TRUE; 
}

Gunakan fungsi DdeSetQualityOfService untuk mengaitkan kualitas layanan yang berbeda dengan jendela klien. Setelah Anda mengubah kualitas layanan, pengaturan baru memengaruhi percakapan berikutnya yang dimulai. Setelah aplikasi memulai percakapan DDE menggunakan kualitas nilai layanan tertentu, aplikasi harus mengakhiri percakapan dan memulai ulang percakapan agar nilai yang berbeda berlaku.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	dde.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll