WSANAMESPACE_INFOW 構造体 (winsock2.h)

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

WSANAMESPACE_INFO構造体には、名前空間プロバイダーのすべての登録情報が含まれています。

構文

typedef struct _WSANAMESPACE_INFOW {
  GUID   NSProviderId;
  DWORD  dwNameSpace;
  BOOL   fActive;
  DWORD  dwVersion;
  LPWSTR lpszIdentifier;
} WSANAMESPACE_INFOW, *PWSANAMESPACE_INFOW, *LPWSANAMESPACE_INFOW;

メンバー

NSProviderId

種類: GUID

この名前空間プロバイダーの一意の GUID。

dwNameSpace

型: DWORD

このプロバイダーでサポートされている名前空間。

dwNameSpace メンバーに指定できる値は、Winsock2.h インクルードファイルに一覧表示されます。 Windows Vista 以降には、いくつかの名前空間プロバイダーが含まれています。他の名前空間プロバイダーをインストールできるため、次の使用可能な値は、一般的に使用できる値のみです。その他の多くの値を使用できます。

値	意味
NS_BTH	Bluetooth 名前空間。この名前空間識別子は、Windows Vista 以降でサポートされています。
NS_DNS	ドメインネームシステム (DNS) 名前空間。
NS_EMAIL	電子メール名前空間。この名前空間識別子は、Windows Vista 以降でサポートされています。
NS_NLA	ネットワークロケーション認識 (NLA) 名前空間。この名前空間識別子は、Windows XP 以降でサポートされています。
NS_NTDS	Windows NT ディレクトリサービス (NTDS) 名前空間。
NS_PNRPNAME	特定のピア名のピアツーピアネームスペース。この名前空間識別子は、Windows Vista 以降でサポートされています。
NS_PNRPCLOUD	ピア名のコレクションのピアツーピア名前空間。この名前空間識別子は、Windows Vista 以降でサポートされています。

fActive

種類: BOOL

TRUE の場合、この名前空間プロバイダーがアクティブであることを示します。 FALSE の場合、名前空間プロバイダーは非アクティブであり、クエリがこの名前空間プロバイダーを特に参照している場合でも、クエリにはアクセスできません。

dwVersion

型: DWORD

名前空間プロバイダーのバージョン番号。

lpszIdentifier

種類: LPTSTR

名前空間プロバイダーを識別する表示文字列。

注釈

WSANAMESPACE_INFO構造体は、使用可能な名前空間プロバイダーに関する情報を返すために、WSAEnumNameSpaceProviders 関数と WSCEnumNameSpaceProviders32 関数によって使用されます。 WSANAMESPACE_INFO構造体には、名前空間プロバイダーのインストール時に WSCInstallNameSpace 関数と WSCInstallNameSpace32 関数に渡される名前空間エントリに関するプロバイダー固有の情報が含まれます。

UNICODE または_UNICODEが定義されている場合、 WSANAMESPACE_INFO は WSANAMESPACE_INFOWに対して定義され、このデータ構造の Unicode バージョンと lpszIdentifier 文字列メンバーは LPWSTR データ型に定義されます。

UNICODE または_UNICODEが定義されていない場合、 WSANAMESPACE_INFO は WSANAMESPACE_INFOA に定義され、このデータ構造の ANSI バージョンと lpszIdentifier 文字列メンバーが LPSTR データ型に定義されます。

Windows Vista 以降では、WSANAMESPACE_INFO構造体の拡張バージョンであるWSANAMESPACE_INFOEXは、WSAEnumNameSpaceProvidersEx および WSCEnumNameSpaceProvidersEx32 関数の呼び出しによって返されます。

注意

winsock2.h ヘッダーは、WSANAMESPACE_INFOをエイリアスとして定義します。これは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

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