HTTP_CHANNEL_BIND_INFO 構造体 (http.h)

HTTP_CHANNEL_BIND_INFO構造体は、チャネル バインド認証を設定またはクエリするために使用されます。

構文

typedef struct _HTTP_CHANNEL_BIND_INFO {
  HTTP_AUTHENTICATION_HARDENING_LEVELS Hardening;
  ULONG                                Flags;
  PHTTP_SERVICE_BINDING_BASE           *ServiceNames;
  ULONG                                NumberOfServiceNames;
} HTTP_CHANNEL_BIND_INFO, *PHTTP_CHANNEL_BIND_INFO;

メンバー

Hardening

サーバー セッションまたは URL グループごとに設定またはクエリを実行するセキュリティ強化レベルを示す HTTP_AUTHENTICATION_HARDENING_LEVELS 値。

Flags

認証の動作を決定するフラグのビットごとの OR の組み合わせ。

次の値がサポートされています。

名前	値	意味
HTTP_CHANNEL_BIND_PROXY	0x1	正確なチャネル バインド トークン (CBT) の一致はバイパスされます。 CBT が 'unbound' と等しくないことを確認します。 サービス プリンシパル名 (SPN) チェックが有効になっています。
HTTP_CHANNEL_BIND_PROXY_COHOSTING	Ox20	このフラグは、HTTP_CHANNEL_BIND_PROXYも設定されている場合にのみ有効です。 フラグを設定すると、CBT チェック ('unbound' と比較) はスキップされます。 プロキシ経由で通過したセキュリティで保護されたチャネル トラフィックと、最初に安全でないチャネルを介して送信されたトラフィックの両方を認証する必要がある場合は、フラグを設定する必要があります。
HTTP_CHANNEL_BIND_NO_SERVICE_NAME_CHECK	0x2	SPN チェックは常に成功します。
HTTP_CHANNEL_BIND_DOTLESS_SERVICE	0x4	ドットなしのサービス名を有効にします。 そうしないと、ドットなしのサービス名を使用して CBT プロパティを構成できません。
HTTP_CHANNEL_BIND_SECURE_CHANNEL_TOKEN	0x8	サーバー セッション、URL グループ、または応答は、要求ごとにセキュリティで保護されたチャネル エンドポイント バインドを取得し、それをユーザーにモード アプリケーションに渡すために構成されます。 設定すると、セキュリティで保護されたチャネル エンドポイント バインドを持つバッファーへのポインターが 、HTTP_REQUEST_CHANNEL_BIND_STATUS 構造体に格納されます。
HTTP_CHANNEL_BIND_CLIENT_SERVICE	0x10	サーバー セッション、URL グループ、または応答は、要求ごとに SPN を取得し、それをユーザー モード アプリケーションに渡すために構成されます。 SPN は、HTTP_REQUEST_CHANNEL_BIND_STATUS構造体の ServiceName フィールドに格納されます。 型は常に HttpServiceBindingTypeW (Unicode) です。

ServiceNames

1 つ以上のサービス名の配列を保持するバッファーへのポインター。 各サービス名は、名前が ASCII か Unicode かに応じて、 HTTP_SERVICE_BINDING_A 構造体または HTTP_SERVICE_BINDING_W 構造体のいずれかで表されます。 使用される構造体の型に関係なく、配列は HTTP_SERVICE_BINDING_BASE 構造体へのポインターにキャストされます。

NumberOfServiceNames

ServiceNames 内の名前の数。

注釈

注  

この構造体は、サーバー セッションまたは URL グループのプロパティを HttpSetServerSessionProperty または HttpSetUrlGroupProperty に渡すことによって設定するために使用されます。

サーバー セッションまたは URL グループのプロパティに対してクエリを実行すると、 HTTP_CHANNEL_BIND_INFO 構造も返されます

 

要件

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