InternetEnumPerSiteCookieDecisionA 関数 (wininet.h)

  • [アーティクル]

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

構文

BOOL InternetEnumPerSiteCookieDecisionA(
  [out]     LPSTR         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) を使用します。
 

注意

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

要件

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

こちらもご覧ください

InternetClearAllPerSiteCookieDecisions

InternetGetPerSiteCookieDecision

InternetSetPerSiteCookieDecision

PrivacyGetZonePreferenceW

PrivacySetZonePreferenceW