InternetEnumPerSiteCookieDecisionW 関数 (winineti.h)

  • [アーティクル]

サイト固有の Cookie 規制が設定されている Web サイトのドメインと Cookie 設定を取得します。

構文

BOOL InternetEnumPerSiteCookieDecisionW(
  [out]     LPWSTR        pszSiteName,
  [in, out] unsigned long *pcSiteNameSize,
  [out]     unsigned long *pdwDecision,
  [in]      unsigned long dwIndex
);

パラメーター

[out] pszSiteName

Web サイト ドメインを指定する文字列を受け取る LPSTR 。

[in, out] pcSiteNameSize

InternetEnumPerSiteCookieDecision 関数が呼び出されたときに提供される pcSiteNameSize パラメーターのサイズを指定する、符号なし long へのポインター。 InternetEnumPerSiteCookieDecision が返されると、pcSiteNameSize は pszSiteName で返されるドメイン文字列の実際の長さを受け取ります。

[out] pdwDecision

pszSiteName に対応する InternetCookieState 列挙値を受け取る符号なし long へのポインター。

[in] dwIndex

Web サイトのインデックスと、取得する対応する Cookie 設定を指定する符号なし long。

戻り値

関数 が指定されたドメインの Cookie 設定を取得した場合は TRUE。それ以外の場合は false。 FALSE。

解説

InternetEnumPerSiteCookieDecision は、 dwIndex を 0 に設定して最初に呼び出す必要があります。 dwIndex パラメーターをインクリメントすると、Web サイトと Cookie 設定の一覧がステップ実行されます。 リストの末尾に達するのは、 InternetEnumPerSiteCookieDecision が FALSE を 返し、wininet エラー ERROR_NO_MORE_ITEMSを生成したときです。

WinINet API の他のすべての側面と同様に、この関数を DllMain またはグローバル オブジェクトのコンストラクターとデストラクター内から安全に呼び出すことはできません。

メモ WinINet では、サーバーの実装はサポートされていません。 また、サービスから使用しないでください。 サーバーの実装またはサービスの場合は、 Microsoft Windows HTTP サービス (WinHTTP) を使用します。
 

注意

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

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winineti.h (Wininet.h、Winineti.h を含む)
Library Wininet.lib
[DLL] Wininet.dll

関連項目

InternetClearAllPerSiteCookieDecisions

InternetGetPerSiteCookieDecision

InternetSetPerSiteCookieDecision

PrivacyGetZonePreferenceW

PrivacySetZonePreferenceW