Win32 API 日本語リファレンス
ホーム › Networking.WinSock › NAPI_PROVIDER_INSTALLATION_BLOB

NAPI_PROVIDER_INSTALLATION_BLOB

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 20 バイト / x86: 20 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド型サイズx64x86説明
dwVersionDWORD4+0+0NS_EMAIL 名前空間プロバイダーのバージョン番号です。このメンバーは名前空間プロバイダーに固有です。
dwProviderTypeDWORD4+4+4NS_EMAIL 名前空間に対する名前空間プロバイダーの種類です。このメンバーには、Nsemail.h ヘッダーファイルで定義されている NAPI_PROVIDER_TYPE 列挙型の値のいずれかを指定できます。
fSupportsWildCardDWORD4+8+8

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

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

cDomainsDWORD4+12+12OffsetFirstDomain メンバーが示す位置から始まる NAPI_DOMAIN_DESCRIPTION_BLOB 構造体の数です。これらの構造体は、この NS_EMAIL 名前空間プロバイダーがサポートするドメインを記述するために使用されます。
OffsetFirstDomainDWORD4+16+16この NS_EMAIL 名前空間プロバイダーがサポートするドメインを記述するために使用される複数の NAPI_DOMAIN_DESCRIPTION_BLOB 構造体のうち、最初の構造体へのオフセット (バイト単位) です。このオフセットは、最低でも 4 バイト境界に配置されている必要があります。

公式ドキュメント

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

解説(Remarks)

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

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

NS_EMAIL 名前空間に登録された各名前空間プロバイダーは、複数のドメインをサポートできます。そのため、NS_EMAIL 名前空間プロバイダーの NAPI_PROVIDER_INSTALLATION_BLOB 構造体には、複数の NAPI_DOMAIN_DESCRIPTION_BLOB 構造体が含まれることがあります。サポートされるドメインの一覧は、NAPI_DOMAIN_DESCRIPTION_BLOB 構造体のリストとしてプロバイダー登録 blob に指定します。サポートされる各ドメインの指定には、NAPI_DOMAIN_DESCRIPTION_BLOB の AuthLevel メンバーに NAPI_PROVIDER_LEVEL 値が含まれ、そのドメインに対してプロバイダーが提供する権限のレベルを示します。

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

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

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

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

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// NAPI_PROVIDER_INSTALLATION_BLOB  (x64 20 / x86 20 バイト)
typedef struct NAPI_PROVIDER_INSTALLATION_BLOB {
    DWORD dwVersion;
    DWORD dwProviderType;
    DWORD fSupportsWildCard;
    DWORD cDomains;
    DWORD OffsetFirstDomain;
} NAPI_PROVIDER_INSTALLATION_BLOB;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NAPI_PROVIDER_INSTALLATION_BLOB
{
    public uint dwVersion;
    public uint dwProviderType;
    public uint fSupportsWildCard;
    public uint cDomains;
    public uint OffsetFirstDomain;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NAPI_PROVIDER_INSTALLATION_BLOB
    Public dwVersion As UInteger
    Public dwProviderType As UInteger
    Public fSupportsWildCard As UInteger
    Public cDomains As UInteger
    Public OffsetFirstDomain As UInteger
End Structure
import ctypes
from ctypes import wintypes

class NAPI_PROVIDER_INSTALLATION_BLOB(ctypes.Structure):
    _fields_ = [
        ("dwVersion", wintypes.DWORD),
        ("dwProviderType", wintypes.DWORD),
        ("fSupportsWildCard", wintypes.DWORD),
        ("cDomains", wintypes.DWORD),
        ("OffsetFirstDomain", wintypes.DWORD),
    ]
#[repr(C)]
pub struct NAPI_PROVIDER_INSTALLATION_BLOB {
    pub dwVersion: u32,
    pub dwProviderType: u32,
    pub fSupportsWildCard: u32,
    pub cDomains: u32,
    pub OffsetFirstDomain: u32,
}
import "golang.org/x/sys/windows"

type NAPI_PROVIDER_INSTALLATION_BLOB struct {
	dwVersion uint32
	dwProviderType uint32
	fSupportsWildCard uint32
	cDomains uint32
	OffsetFirstDomain uint32
}
type
  NAPI_PROVIDER_INSTALLATION_BLOB = record
    dwVersion: DWORD;
    dwProviderType: DWORD;
    fSupportsWildCard: DWORD;
    cDomains: DWORD;
    OffsetFirstDomain: DWORD;
  end;
const NAPI_PROVIDER_INSTALLATION_BLOB = extern struct {
    dwVersion: u32,
    dwProviderType: u32,
    fSupportsWildCard: u32,
    cDomains: u32,
    OffsetFirstDomain: u32,
};
type
  NAPI_PROVIDER_INSTALLATION_BLOB {.bycopy.} = object
    dwVersion: uint32
    dwProviderType: uint32
    fSupportsWildCard: uint32
    cDomains: uint32
    OffsetFirstDomain: uint32
struct NAPI_PROVIDER_INSTALLATION_BLOB
{
    uint dwVersion;
    uint dwProviderType;
    uint fSupportsWildCard;
    uint cDomains;
    uint OffsetFirstDomain;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NAPI_PROVIDER_INSTALLATION_BLOB サイズ: 20 バイト(x64)
dim st, 5    ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; dwVersion : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwProviderType : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; fSupportsWildCard : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; cDomains : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; OffsetFirstDomain : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global NAPI_PROVIDER_INSTALLATION_BLOB
    #field int dwVersion
    #field int dwProviderType
    #field int fSupportsWildCard
    #field int cDomains
    #field int OffsetFirstDomain
#endstruct

stdim st, NAPI_PROVIDER_INSTALLATION_BLOB        ; NSTRUCT 変数を確保
st->dwVersion = 100
mes "dwVersion=" + st->dwVersion