PrivacyGetZonePreferenceW, fonction (wininet.h)

Article
03/04/2024

Récupère les paramètres de confidentialité d’une URLZONE et d’un PrivacyType donnés.

Syntaxe

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

Paramètres

[in] dwZone

Valeur de type DWORD qui spécifie l’URLZONE pour laquelle les paramètres de confidentialité sont récupérés.

[in] dwType

Valeur de type DWORD qui spécifie le PrivacyType pour lequel les paramètres de confidentialité sont récupérés.

[out, optional] pdwTemplate

LPDWORD qui retourne un pointeur vers un DWORD contenant lequel des PrivacyTemplates est utilisé pour cette zone dwZone et dwType.

[out, optional] pszBuffer

LPWSTR qui pointe vers une mémoire tampon contenant un LPCWSTR représentant une version de chaîne du pdwTemplate ou une chaîne personnalisée si la valeur pdwTemplate est PRIVACY_TEMPLATE_CUSTOM. Consultez PrivacySetZonePreferenceW pour obtenir une description d’une chaîne de préférences de confidentialité personnalisée.

[in, out, optional] pdwBufferLength

LPDWORD qui contient la longueur de la mémoire tampon en caractères. Si la longueur de la mémoire tampon n’est pas suffisante, PrivacyGetZonePreferenceW retourne avec ce paramètre défini sur le nombre de caractères requis et avec une valeur de retour de ERROR_MORE_DATA.

Valeur retournée

Retourne zéro si l’opération réussit. Sinon, l’un des messages d’erreur définis dans winerr.h est retourné.

Remarques

Ces paramètres de confidentialité pour la zone Internet se trouvent sous l’onglet Confidentialité de la boîte de dialogue Options Internet.

Comme tous les autres aspects de l’API WinINet, cette fonction ne peut pas être appelée en toute sécurité à partir de DllMain ou des constructeurs et destructeurs d’objets globaux.

Note WinINet ne prend pas en charge les implémentations de serveur. En outre, il ne doit pas être utilisé à partir d’un service. Pour les implémentations de serveur ou les services, utilisez Microsoft Windows HTTP Services (WinHTTP).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wininet.h (inclure Wininet.h)
Bibliothèque	Wininet.lib
DLL	Wininet.dll

Voir aussi

InternetClearAllPerSiteCookieDecisions

InternetEnumPerSiteCookieDecision

InternetGetPerSiteCookieDecision

InternetSetPerSiteCookieDecisions

PrivacySetZonePreferenceW

Partager via