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 値 | 説明 |
|---|---|
|
IP リッスン リストから指定した IP アドレスを削除します。 |
|
指定した SSL 証明書レコードを削除します。 |
|
指定した URL 予約レコードを削除します。 |
|
指定した接続タイムアウトを削除します。
Windows Vista 以降: この列挙はサポートされています。 |
|
指定した SSL サーバー名表示 (SNI) 証明書レコードを削除します。
Windows 8 以降: この列挙値はサポートされています。 |
|
ポートがトランスポート層セキュリティ (TLS) ハンドシェイクを受け取った場合に、Http.sys が一元化された証明書ストア (CCS) ストアを参照して証明書を検索する必要があることを指定する SSL 証明書レコードを削除します。 ポートは、pConfigInformation パラメーターに渡すHTTP_SERVICE_CONFIG_SSL_CCS_SET構造体の KeyDesc メンバーによって指定されます。
Windows 8 以降: この列挙値はサポートされています。 |
[in] pConfigInformation
ConfigId パラメーターで指定された構成の種類に必要なデータを含むバッファーへのポインター。
| ConfigId 値 | 説明 |
|---|---|
|
|
|
|
|
|
|
HTTP_SERVICE_CONFIG_TIMEOUT_KEY 構造体。 Windows Vista 以降: この構造体はサポートされています。 |
|
HTTP_SERVICE_CONFIG_SSL_SNI_SET 構造体。 ホスト名は、SSL 中央証明書ストアに対してクエリが実行され、ワイルドカード バインドが使用され、通常の SNI のホスト名が "*" になります。 Windows 8 以降: この構造体はサポートされています。 |
|
HTTP_SERVICE_CONFIG_SSL_CCS_SET 構造体。 Windows 8 以降: この構造体はサポートされています。 |
[in] ConfigInformationLength
pConfigInformation バッファーのサイズ (バイト単位)。
[in] pOverlapped
将来の非同期操作用に予約されています。 このパラメーターは NULL に設定する必要があります。
戻り値
関数が成功した場合、関数はNO_ERRORを返します。
関数が失敗すると、次のいずれかのエラー コードが返されます。
| 値 | 説明 |
|---|---|
|
パラメーターの 1 つが無効です。 |
|
WinError.h で定義されている システム エラー コード 。 |
要件
| サポートされている最小のクライアント | Windows Vista、WINDOWS XP と SP2 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | http.h |
| Library | Httpapi.lib |
| [DLL] | Httpapi.dll |