PrivacyGetZonePreferenceW 関数 (winineti.h)

  • [アーティクル]

特定の URLZONE と PrivacyType のプライバシー設定を取得します。

構文

DWORD PrivacyGetZonePreferenceW(
  [in]                DWORD   dwZone,
  [in]                DWORD   dwType,
  [out, optional]     LPDWORD pdwTemplate,
  [out, optional]     LPWSTR  pszBuffer,
  [in, out, optional] LPDWORD pdwBufferLength
);

パラメーター

[in] dwZone

プライバシー設定を取得する URLZONE を指定する DWORD 型の値。

[in] dwType

プライバシー設定を取得する PrivacyType を指定する DWORD 型の値。

[out, optional] pdwTemplate

この dwZone と dwType に使用されている PrivacyTemplates を含む DWORD へのポインターを返す LPDWORD。

[out, optional] pszBuffer

pdwTemplate が PRIVACY_TEMPLATE_CUSTOM に設定されている場合は、pdwTemplate の文字列バージョンを表す LPCWSTR またはカスタマイズされた文字列を表すバッファーを指す LPWSTR。 カスタマイズされたプライバシー設定文字列の説明については 、「PrivacySetZonePreferenceW 」を参照してください。

[in, out, optional] pdwBufferLength

バッファーの長さを文字数で表す LPDWORD 。 バッファーの長さが十分でない場合、 PrivacyGetZonePreferenceW は、このパラメーターを必要な文字数に設定し、戻り値 をERROR_MORE_DATAで返します。

戻り値

正常終了した場合は 0 を返します。 それ以外の場合は、winerr.h で定義されているエラー メッセージのいずれかが返されます。

解説

インターネット ゾーンのこれらのプライバシー設定は、[インターネット オプション] ダイアログ ボックスの [プライバシー] タブにあります。

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

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

要件

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

関連項目

InternetClearAllPerSiteCookieDecisions

InternetEnumPerSiteCookieDecision

InternetGetPerSiteCookieDecision

InternetSetPerSiteCookieDecisions

PrivacySetZonePreferenceW