struktur NAPI_PROVIDER_INSTALLATION_BLOB (nsemail.h)

Artikel
08/25/2023

Struktur NAPI_PROVIDER_INSTALLATION_BLOB berisi informasi yang diperlukan untuk menginstal penyedia namespace layanan untuk namespace NS_EMAIL.

Sintaks

typedef struct napi_provider_installation_blob_tag {
  DWORD dwVersion;
  DWORD dwProviderType;
  DWORD fSupportsWildCard;
  ULONG cDomains;
  ULONG OffsetFirstDomain;
} NAPI_PROVIDER_INSTALLATION_BLOB;

Anggota

dwVersion

Jenis: DWORD

Nomor versi penyedia namespace NS_EMAIL. Anggota ini khusus untuk penyedia namespace layanan.

dwProviderType

Jenis: DWORD

Jenis penyedia namespace layanan untuk namespace NS_EMAIL. Anggota ini bisa menjadi salah satu nilai dari jenis enumerasi NAPI_PROVIDER_TYPE yang ditentukan dalam file header Nsemail.h .

fSupportsWildCard

Jenis: DWORD

Nilai Boolean yang menunjukkan apakah penyedia namespace NS_EMAIL ini mendukung nama kartubebas. Jika anggota ini bukan nol, maka penyedia NS_EMAIL mengklaim berpotensi dapat menyelesaikan atau mendaftarkan nama apa pun yang bukan milik domain apa pun yang didaftarkan secara khusus oleh penyedia sebagai primer atau sekunder. Jika anggota ini bukan nol, penyedia NS_EMAIL dapat dipanggil untuk menyelesaikan atau mendaftarkan alamat apa pun, jika tidak ada penyedia utama atau sekunder untuk domain yang tersedia.

Mungkin ada beberapa penyedia yang mengklaim dapat menyelesaikan alamat apa pun ( fSupportsWildCard diatur ke nonzero). Jika ada penyedia namespace layanan dengan nilai ini yang juga terdaftar sebagai penyedia kartubebas, penyedia dipanggil dalam urutan yang mereka munculkan di katalog namespace Winsock.

cDomains

Jenis: DWORD

Jumlah NAPI_DOMAIN_DESCRIPTION_BLOB menyusun awal di anggota OffsetFirstDomain yang digunakan untuk menjelaskan domain yang didukung oleh penyedia namespace NS_EMAIL ini.

OffsetFirstDomain

Jenis: DWORD

Offset, dalam byte, ke yang pertama dari beberapa struktur NAPI_DOMAIN_DESCRIPTION_BLOB yang digunakan untuk menjelaskan domain yang didukung oleh penyedia namespace NS_EMAIL ini. Offset ini harus diselaraskan pada batas minimal empat byte.

Keterangan

Struktur ini didukung pada Windows Vista dan yang lebih baru.

Struktur NAPI_PROVIDER_INSTALLATION_BLOB berisi informasi yang diperlukan untuk menginstal penyedia namespace layanan untuk namespace NS_EMAIL. Mungkin ada beberapa penyedia namespace layanan untuk penginstalan namespace NS_EMAIL pada sistem lokal.

Setiap penyedia namespace yang terdaftar di namespace NS_EMAIL dapat mendukung beberapa domain. Akibatnya, mungkin ada beberapa struktur NAPI_DOMAIN_DESCRIPTION_BLOB dalam struktur NAPI_PROVIDER_INSTALLATION_BLOB untuk penyedia namespace NS_EMAIL. 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 tingkat otoritas yang disediakan oleh penyedia untuk domain tersebut.

Penyedia namespace dipanggil dalam urutan berikut untuk menyelesaikan atau mendaftarkan alamat di domain. Jika penyedia namespace terdaftar sebagai penyedia utama untuk domain, penyedia utama ini akan 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, 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.

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 semua penyedia namespace layanan (termasuk penyedia namespace NS_EMAIL) dan untuk mengambil struktur NAPI_PROVIDER_INSTALLATION_BLOB untuk penyedia jika penyedia mendaftarkan blob saat penginstalan.

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