NAPI_PROVIDER_INSTALLATION_BLOB構造体 (nsemail.h)
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 |