NAPI_PROVIDER_INSTALLATION_BLOB構造体 (nsemail.h)

[アーティクル]
08/25/2023

NAPI_PROVIDER_INSTALLATION_BLOB構造体には、NS_EMAIL名前空間の名前空間プロバイダーをインストールするために必要な情報が含まれています。

構文

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

メンバー

dwVersion

型: DWORD

NS_EMAIL名前空間プロバイダーのバージョン番号。このメンバーは名前空間プロバイダーに固有です。

dwProviderType

型: DWORD

NS_EMAIL名前空間の名前空間プロバイダーの型。このメンバーは、Nsemail.h ヘッダーファイルで定義されているNAPI_PROVIDER_TYPE列挙型の値のいずれかになります。

fSupportsWildCard

型: DWORD

このNS_EMAIL名前空間プロバイダーがワイルドカード名をサポートしているかどうかを示すブール値。このメンバーが 0 以外の場合、NS_EMAIL プロバイダーは、プロバイダーがプライマリまたはセカンダリとして特に登録されているドメインに属していない名前を解決または登録できる可能性があると主張します。このメンバーが 0 以外の場合、ドメインのプライマリプロバイダーまたはセカンダリプロバイダーが使用できない場合は、アドレスを解決または登録するために、NS_EMAIL プロバイダーを呼び出す可能性があります。

任意のアドレスを解決できると主張するプロバイダーが複数存在する場合があります ( fSupportsWildCard が 0 以外に設定されています)。ワイルドカードプロバイダーとしても登録されているこの値を持つ名前空間プロバイダーがある場合、プロバイダーは Winsock 名前空間カタログに表示される順序で呼び出されます。

cDomains

型: DWORD

この NS_EMAIL 名前空間プロバイダーでサポートされているドメインを記述するために使用される OffsetFirstDomain メンバーから始まるNAPI_DOMAIN_DESCRIPTION_BLOB構造体の数。

OffsetFirstDomain

型: DWORD

このNS_EMAIL名前空間プロバイダーでサポートされているドメインを記述するために使用される複数の NAPI_DOMAIN_DESCRIPTION_BLOB 構造体の最初のオフセット (バイト単位)。このオフセットは、少なくとも 4 バイトの境界に配置する必要があります。

注釈

この構造は、Windows Vista 以降でサポートされています。

NAPI_PROVIDER_INSTALLATION_BLOB構造体には、NS_EMAIL名前空間の名前空間プロバイダーをインストールするために必要な情報が含まれています。ローカルシステムにNS_EMAIL名前空間をインストールするための複数の名前空間プロバイダーが存在する場合があります。

NS_EMAIL名前空間に登録されている各名前空間プロバイダーは、複数のドメインをサポートできます。その結果、NS_EMAIL名前空間プロバイダーの NAPI_PROVIDER_INSTALLATION_BLOB 構造体に複数の NAPI_DOMAIN_DESCRIPTION_BLOB 構造体が存在する可能性があります。サポートされているドメインの一覧は、プロバイダー登録 BLOB で NAPI_DOMAIN_DESCRIPTION_BLOB 構造の一覧として指定されます。サポートされている各ドメイン仕様には、 NAPI_DOMAIN_DESCRIPTION_BLOB の AuthLevel メンバーに NAPI_PROVIDER_LEVEL 値が含まれています。この値は、そのドメインのプロバイダーによって提供される権限のレベルを記述します。

名前空間プロバイダーは、ドメイン内のアドレスを解決または登録するために、次の順序で呼び出されます。名前空間プロバイダーがドメインのプライマリプロバイダーとして登録されている場合は、最初にこのプライマリプロバイダーが呼び出されます。名前空間クエリで権限のある結果が要求されるかどうかに応じて、2 つのケースがあります。クエリの既定値は、信頼できる結果を要求することです。

クエリで権限のある結果が要求されると、名前空間プロバイダーが次のように呼び出されます。プライマリプロバイダーが使用できない場合、またはアドレスを解決または登録できない場合は、Winsock カタログの最初のセカンダリプロバイダーが呼び出されます。セカンダリプロバイダーが使用できない場合、またはアドレスを解決または登録できない場合は、Winsock カタログ内の次のセカンダリプロバイダーが呼び出されます。すべてのセカンダリプロバイダーが使用できない場合、またはアドレスを解決または登録できない場合は、Winsock カタログの最初のワイルドカードプロバイダーが呼び出されます。最初のワイルドカードプロバイダーが使用できない場合、またはアドレスを解決または登録できない場合は、Winsock カタログ内の次のワイルドカードプロバイダーが呼び出されます。

権限のない結果がクエリで要求されると、名前空間プロバイダーが次のように呼び出されます。プライマリプロバイダー、すべてのセカンダリプロバイダー、およびすべてのワイルドカードプロバイダーが呼び出され、すべてのクエリの結果が返されます。プライマリプロバイダーは最初に呼び出されます。セカンダリプロバイダーは、Winsock カタログの順序に基づいて次に呼び出されます。ワイルドカードプロバイダーは、Winsock カタログの順序に基づいて、次に呼び出されます。返される結果は、クエリの順序に基づいています。

WSCInstallNameSpaceEx および WSCInstallNameSpaceEx32 関数は、NAPI_PROVIDER_INSTALLATION_BLOB構造体を使用して、NS_EMAIL名前空間の名前空間プロバイダーをインストールするために使用されます。

WSAEnumNameSpaceProvidersEx 関数と WSCEnumNameSpaceProvidersEx32 関数は、すべての名前空間プロバイダー (NS_EMAIL名前空間プロバイダーを含む) を列挙し、プロバイダーがインストール時に BLOB を登録した場合にプロバイダーのNAPI_PROVIDER_INSTALLATION_BLOB構造を取得するために使用されます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
Header	nsemail.h