InternetEnumPerSiteCookieDecisionW

InternetEnumPerSiteCookieDecisionW (Unicode) 関数 (wininet.h) は、サイト固有のクッキー規制が設定された Web サイトのドメインとクッキー設定を取得する。

InternetEnumPerSiteCookieDecisionW pszSiteName, pcSiteNameSize, pdwDecision, dwIndex

pszSiteName : [wstr] Web サイトドメインを指定する文字列を受け取る LPSTR。
pcSiteNameSize : [var] InternetEnumPerSiteCookieDecision 関数の呼び出し時に提供される pcSiteNameSize パラメータのサイズを指定する unsigned long へのポインタ。InternetEnumPerSiteCookieDecision が戻ると、pcSiteNameSize には pszSiteName に返されたドメイン文字列の実際の長さが格納される。
pdwDecision : [var] pszSiteName に対応する InternetCookieState 列挙値を受け取る unsigned long へのポインタ。
dwIndex : [int] 取得する Web サイトと対応するクッキー設定のインデックスを指定する unsigned long。

(プラグイン / モジュール : wininet.dll)

解説

InternetEnumPerSiteCookieDecisionW (Unicode) 関数 (wininet.h)
は、サイト固有のクッキー規制が設定された Web サイトのドメインとクッキー設定を取得する。

[戻り値]
指定したドメインのクッキー設定を取得した場合は TRUE を、そうでない場合は FALSE を返す。

[備考]
InternetEnumPerSiteCookieDecision は最初に dwIndex を 0
にして呼び出すべきである。dwIndex パラメータをインクリメントすることで Web
サイトとクッキー設定のリストを順に辿る。InternetEnumPerSiteCookieDecision が FALSE
を返し、wininet エラー ERROR_NO_MORE_ITEMS を発生させた時点でリストの末尾に到達する。WinINet API
の他のすべての側面と同様に、本関数は DllMain
やグローバルオブジェクトのコンストラクタ・デストラクタの中から安全に呼び出すことはできない。注意: WinINet
はサーバー実装をサポートしていない。さらに、サービスから使用すべきでもない。サーバー実装やサービスでは Microsoft Windows
HTTP Services (WinHTTP) を使用すること。
> [!NOTE] > wininet.h ヘッダーは InternetEnumPerSiteCookieDecision
をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に基づいて本関数の ANSI 版または Unicode
版を自動的に選択する。エンコーディング中立のエイリアスとエンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーの原因となるミスマッチが発生する可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報