HttpDeleteServiceConfiguration 関数 (http.h)

  • [アーティクル]

HttpDeleteServiceConfiguration 関数は、指定されたデータ (IP アドレスや SSL 証明書など) を HTTP Server API 構成ストアから一度に 1 レコードずつ削除します。

構文

HTTPAPI_LINKAGE ULONG HttpDeleteServiceConfiguration(
  [in] HANDLE                 ServiceHandle,
  [in] HTTP_SERVICE_CONFIG_ID ConfigId,
  [in] PVOID                  pConfigInformation,
  [in] ULONG                  ConfigInformationLength,
  [in] LPOVERLAPPED           pOverlapped
);

パラメーター

[in] ServiceHandle

このパラメーターは予約されており、0 である必要があります。

[in] ConfigId

構成の種類。 このパラメーターは、HTTP_SERVICE_CONFIG_ID列挙の値の 1 つです。

ConfigId 値 説明
HttpServiceConfigIPListenList
 IP リッスン リストから指定した IP アドレスを削除します。
HttpServiceConfigSSLCertInfo
 指定した SSL 証明書レコードを削除します。
HttpServiceConfigUrlAclInfo
 指定した URL 予約レコードを削除します。
HttpServiceConfigTimeout
 指定した接続タイムアウトを削除します。

Windows Vista 以降: この列挙はサポートされています。
HttpServiceConfigSslSniCertInfo
 指定した SSL サーバー名表示 (SNI) 証明書レコードを削除します。

Windows 8 以降: この列挙値はサポートされています。
HttpServiceConfigSslCcsCertInfo
 ポートがトランスポート層セキュリティ (TLS) ハンドシェイクを受け取った場合に、Http.sys が一元化された証明書ストア (CCS) ストアを参照して証明書を検索する必要があることを指定する SSL 証明書レコードを削除します。 ポートは、pConfigInformation パラメーターに渡すHTTP_SERVICE_CONFIG_SSL_CCS_SET構造体の KeyDesc メンバーによって指定されます。

Windows 8 以降: この列挙値はサポートされています。

[in] pConfigInformation

ConfigId パラメーターで指定された構成の種類に必要なデータを含むバッファーへのポインター。

ConfigId 値 説明
HttpServiceConfigIPListenList

HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM 構造体。
HttpServiceConfigSSLCertInfo

HTTP_SERVICE_CONFIG_SSL_SET 構造体。
HttpServiceConfigUrlAclInfo

HTTP_SERVICE_CONFIG_URLACL_SET 構造体。
HttpServiceConfigTimeouts

HTTP_SERVICE_CONFIG_TIMEOUT_KEY 構造体。

Windows Vista 以降: この構造体はサポートされています。
HttpServiceConfigSslSniCertInfo

HTTP_SERVICE_CONFIG_SSL_SNI_SET 構造体。 ホスト名は、SSL 中央証明書ストアに対してクエリが実行され、ワイルドカード バインドが使用され、通常の SNI のホスト名が "*" になります。

Windows 8 以降: この構造体はサポートされています。
HttpServiceConfigSslCcsCertInfo

HTTP_SERVICE_CONFIG_SSL_CCS_SET 構造体。

Windows 8 以降: この構造体はサポートされています。

[in] ConfigInformationLength

pConfigInformation バッファーのサイズ (バイト単位)。

[in] pOverlapped

将来の非同期操作用に予約されています。 このパラメーターは NULL に設定する必要があります。

戻り値

関数が成功した場合、関数はNO_ERRORを返します。

関数が失敗すると、次のいずれかのエラー コードが返されます。

値 説明
ERROR_INVALID_PARAMETER
 パラメーターの 1 つが無効です。
その他
 WinError.h で定義されている システム エラー コード 。

要件

   
サポートされている最小のクライアント Windows Vista、WINDOWS XP と SP2 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー http.h
Library Httpapi.lib
[DLL] Httpapi.dll

関連項目

HTTP Server API バージョン 1.0 関数

HttpQueryServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration