SERVICE_TYPE_VALUE_ABSA 構造体 (nspapi.h)

  • [アーティクル]

SERVICE_TYPE_VALUE_ABS構造体には、ネットワーク サービスの種類の値に関する情報が含まれています。 この情報は、名前空間に固有である可能性があります。

構文

typedef struct _SERVICE_TYPE_VALUE_ABSA {
  DWORD dwNameSpace;
  DWORD dwValueType;
  DWORD dwValueSize;
  LPSTR lpValueName;
  PVOID lpValue;
} SERVICE_TYPE_VALUE_ABSA, *PSERVICE_TYPE_VALUE_ABSA, *LPSERVICE_TYPE_VALUE_ABSA;

メンバー

dwNameSpace

型: DWORD

ネットワーク サービスの種類の値が意図されている名前空間、または既定の名前空間のセット。 名前空間プロバイダーは、その名前空間を対象とした値のみを確認します。

名前空間を指定するには、次のいずれかの定数を使用します。

値 意味
NS_DEFAULT
 既定の名前空間のセット。 関数は、このセット内の各名前空間に対してクエリを実行します。 既定の名前空間のセットには、通常、システムにインストールされているすべての名前空間が含まれます。 ただし、システム管理者は、セットから特定の名前空間を除外できます。 NS_DEFAULTは、ほとんどのアプリケーションが dwNameSpace に使用する必要がある値です。
NS_DNS
 ホスト名解決のためにインターネットで使用されるドメイン ネーム システム。
NS_NETBT
 TCP/IP 経由の NetBIOS レイヤー。 すべての Windows オペレーティング システムは、コンピューター名を NetBIOS に登録します。 この名前空間は、コンピューター名を、この登録を使用する IP アドレスに変換するために使用されます。 NS_NETBTが WINS サーバーにアクセスして解決を実行する場合があることに注意してください。
NS_SAP
 NetWare サービスアドバタイズ プロトコル。 必要に応じて、NetWare バインダーにアクセスできます。 NS_SAPは、サービスの登録を許可する動的名前空間です。
NS_TCPIP_HOSTS
 systemroot>\system32\drivers\etc\hosts ファイル内<の参照値。
NS_TCPIP_LOCAL
 ローカル TCP/IP 名前解決メカニズム。ローカル ホスト名との比較や、ホストと IP アドレスのマッピングのキャッシュ内のホスト名と IP アドレスの検索が含まれます。

dwValueType

型: DWORD

値データの型。 次のいずれかの型を指定します。

値 意味
REG_BINARY
 任意の形式のバイナリ データ。
REG_DWORD
 32 ビット数値。
REG_MULTI_SZ
 null で終わる文字列の配列。配列は、2 つの null 文字で終わります。
REG_SZ
 null で終わる文字列。

dwValueSize

型: DWORD

lpValue メンバーが指す値のサイズ (バイト単位)。 REG_SZおよびREG_MULTI_SZ文字列データの場合、終了文字はサイズの一部としてカウントされます。

lpValueName

種類: LPTSTR

値の名前である NULL で終わる文字列へのポインター。 この名前は名前空間に固有です。

いくつかの一般的に使用される値名の文字列は、定義された定数に関連付けられています。 これらの名前の文字列には、次のものが含まれます。

定数 説明
SERVICE_TYPE_VALUE_SAPID
 "SapId"
SERVICE_TYPE_VALUE_CONN
 "ConnectionOriented"
SERVICE_TYPE_VALUE_TCPPORT
 "TcpPort"
SERVICE_TYPE_VALUE_UDPPORT
 "UdpPort"

lpValue

種類: PVOID

値データへのポインター。

注釈

SetService 関数を使用してネットワーク サービスの種類を名前空間に追加すると、SERVICE_TYPE_INFO_ABS構造体がSERVICE_INFO構造体の ServiceSpecificInfo BLOB メンバーとして渡されます。 ServiceSpecificInfo メンバーには通常、ポインターを含めてはなりませんが、SERVICE_TYPE_INFO_ABS構造体と SERVICE_TYPE_VALUE_ABS 構造体の場合は例外が発生します。

注意

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

要件

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

こちらもご覧ください

SERVICE_INFO

SERVICE_TYPE_INFO_ABS

SetService