PrivacyGetZonePreferenceW 函式 (wininet.h)

發行項
03/09/2024

語法

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

參數

[in] dwZone

DWORD 類型的值，指定要擷取隱私權設定的 URLZONE。

[in] dwType

DWORD 類型的值，指定要擷取隱私權設定的 PrivacyType。

[out, optional] pdwTemplate

LPDWORD，會傳回 DWORD 的指標，其中包含此 dwZone 和 dwType 所使用的 PrivacyTemplates。

[out, optional] pszBuffer

指向包含 LPCWSTR 的緩衝區的 LPWSTR，代表 pdwTemplate 的字串版本，如果 pdwTemplate 設定為 PRIVACY_TEMPLATE_CUSTOM，則為自定義字串。如需自定義隱私權喜好設定字串的描述，請參閱 PrivacySetZonePreferenceW 。

[in, out, optional] pdwBufferLength

包含字元中緩衝區長度的 LPDWORD 。如果緩衝區長度不足， PrivacyGetZonePreferenceW 會傳回此參數設定為所需的字元數，且傳回值為 ERROR_MORE_DATA。

傳回值

如果成功，會傳回零。否則，會傳回 winerr.h 中定義的其中一個錯誤訊息。

備註

這些因特網區域的隱私權設定位於 [因特網選項] 對話方塊的 [隱私權] 索引卷標上。

就像 WinINet API 所有其他層面一樣，您無法從 DllMain 或全域物件的建構函式和解構函式安全地呼叫此函式。

注意 WinINet 不支援伺服器實作。此外，不應該從服務使用它。對於伺服器實作或服務，請使用 Microsoft Windows HTTP Services (WinHTTP) 。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	wininet.h (包含 Wininet.h)
程式庫	Wininet.lib
Dll	Wininet.dll