enumerasi NAPI_PROVIDER_LEVEL (nsemail.h)

Artikel
03/08/2023

Enumerasi NAPI_PROVIDER_LEVEL menentukan tingkat otoritas penyedia dari penyedia namespace NS_EMAIL untuk domain tertentu.

Sintaks

typedef enum napi_provider_level_tag {
  ProviderLevel_None = 0,
  ProviderLevel_Secondary,
  ProviderLevel_Primary
} NAPI_PROVIDER_LEVEL;

Konstanta


`ProviderLevel_None` Nilai: 0 Penyedia namespace tidak mendukung domain saat ini. Nilai ini dapat digunakan untuk menonaktifkan dukungan untuk domain untuk sementara waktu tanpa menghapusnya dari daftar domain yang didukung. Jika ProviderLevel_None diatur dalam anggota AuthLevel dari NAPI_DOMAIN_DESCRIPTION_BLOB untuk domain tertentu ketika penyedia diinstal dan terdaftar, penyedia namespace tidak akan dipanggil untuk menyelesaikan atau mendaftarkan alamat di domain tersebut kecuali penyedia terdaftar sebagai penyedia kartubebas. Mungkin ada beberapa penyedia namespace NS_EMAIL untuk domain dengan nilai ProviderLevel_None. Jika ada penyedia namespace layanan dengan nilai ini yang juga terdaftar sebagai penyedia kartubebas, penyedia dipanggil dalam urutan yang mereka munculkan di katalog Winsock.
`ProviderLevel_Secondary` Penyedia namespace adalah penyedia sekunder untuk domain di namespace NS_EMAIL. Penyedia namespace dapat menjadi penyedia sekunder di domain target jika penyedia dapat menyelesaikan dan mendaftarkan nama NS_EMAIL untuk domain ini dan memberikan jawaban yang sama dengan yang akan diberikan penyedia utama. Jika ProviderLevel_Secondary diatur dalam anggota AuthLevel dari NAPI_DOMAIN_DESCRIPTION_BLOB untuk domain tertentu ketika penyedia diinstal dan terdaftar, penyedia ini dipanggil ketika penyedia utama untuk domain saat ini tidak tersedia atau penyedia utama tidak dapat menyelesaikan atau mendaftarkan alamat di domain tersebut. Mungkin ada beberapa penyedia namespace NS_EMAIL sekunder untuk domain dengan nilai ProviderLevel_Secondary. Jika ada beberapa penyedia namespace sekunder, penyedia dipanggil dalam urutan muncul di katalog Winsock.
`ProviderLevel_Primary` Penyedia namespace adalah penyedia utama untuk domain di namespace NS_EMAIL. Penyedia namespace dapat mengklaim sebagai penyedia utama untuk domain jika memiliki semua nama NS_EMAIL untuk domain tersebut dan dengan demikian memiliki akses ke data master untuk semua nama tersebut. Seharusnya hanya ada satu penyedia namespace NS_EMAIL utama untuk domain yang terdaftar di sistem lokal. Catatan Tidak boleh ada dua penyedia namespace NS_EMAIL yang mengklaim sebagai penyedia utama untuk domain yang sama. Jika beberapa penyedia mencoba mendaftar sebagai penyedia utama untuk domain yang sama, penyedia pertama yang ditemukan di katalog namespace Winsock untuk domain karena penyedia utama akan dipanggil. Semua penyedia lain mengklaim sebagai penyedia utama diabaikan.

Keterangan

Enumerasi ini didukung pada Windows Vista dan yang lebih baru.

Enumerasi NAPI_PROVIDER_LEVEL digunakan oleh struktur NAPI_DOMAIN_DESCRIPTION_BLOB untuk menentukan tingkat otoritas penyedia namespace NS_EMAIL untuk domain. Setiap penyedia namespace yang terdaftar di namespace NS_EMAIL dapat mendukung beberapa domain. Daftar domain yang didukung ditentukan dalam blob pendaftaran penyedia sebagai daftar struktur NAPI_DOMAIN_DESCRIPTION_BLOB . Setiap spesifikasi domain yang didukung berisi nilai NAPI_PROVIDER_LEVEL di anggota AuthLevel dari NAPI_DOMAIN_DESCRIPTION_BLOB yang menjelaskan jenis dukungan yang disediakan oleh penyedia untuk domain tersebut.

Selain domain yang ditentukan, penyedia namespace NS_EMAIL juga dapat mendaftar sebagai penyedia kartubebas untuk mencoba dan mendukung domain apa pun, dengan menentukan anggota fSupportsWildCard sebagai bukan nol di NAPI_PROVIDER_INSTALLATION_BLOB diteruskan saat penyedia diinstal.

Penyedia namespace dipanggil dalam urutan berikut untuk menyelesaikan atau mendaftarkan alamat di domain. Jika penyedia namespace terdaftar sebagai penyedia utama untuk domain, maka penyedia utama ini dipanggil terlebih dahulu. Ada dua kasus tergantung pada apakah hasil otoritatif diminta dalam kueri namespace. Default untuk kueri adalah meminta hasil otoritatif.

Saat hasil otoritatif diminta dalam kueri, maka penyedia namespace dipanggil sebagai berikut. Jika penyedia utama tidak tersedia atau tidak dapat menyelesaikan atau mendaftarkan alamat, maka penyedia sekunder pertama di katalog Winsock dipanggil. Jika penyedia sekunder tidak tersedia atau tidak dapat menyelesaikan atau mendaftarkan alamat, maka penyedia sekunder berikutnya di katalog Winsock dipanggil. Jika semua penyedia sekunder tidak tersedia atau tidak dapat menyelesaikan atau mendaftarkan alamat, maka penyedia kartubebas pertama di katalog Winsock dipanggil. Jika penyedia kartubebas pertama tidak tersedia atau tidak dapat menyelesaikan atau mendaftarkan alamat, maka penyedia kartubebas berikutnya di katalog Winsock dipanggil.

Saat hasil non-otoritatif diminta dalam kueri, maka penyedia namespace dipanggil sebagai berikut. Penyedia utama, semua penyedia sekunder, dan semua penyedia kartubebas dipanggil dan hasil dari semua kueri dikembalikan. Penyedia utama dipanggil terlebih dahulu. Penyedia sekunder dipanggil berikutnya, berdasarkan urutan dalam katalog Winsock. Penyedia kartubebas dipanggil berikutnya, berdasarkan urutan dalam katalog Winsock. Hasil yang dikembalikan didasarkan pada urutan kueri.

Struktur NAPI_DOMAIN_DESCRIPTION_BLOB digunakan dalam struktur NAPI_PROVIDER_INSTALLATION_BLOB untuk menjelaskan penyedia namespace NS_EMAIL.

Fungsi WSCInstallNameSpaceEx dan WSCInstallNameSpaceEx32 digunakan untuk menginstal penyedia namespace layanan untuk namespace NS_EMAIL menggunakan struktur NAPI_PROVIDER_INSTALLATION_BLOB .

Fungsi WSAEnumNameSpaceProvidersEx dan WSCEnumNameSpaceProvidersEx32 digunakan untuk menghitung penyedia namespace layanan untuk namespace NS_EMAIL dan mengambil struktur NAPI_PROVIDER_INSTALLATION_BLOB untuk penyedia.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	nsemail.h