IPStore::WriteItem, méthode

[Le stockage protégé (Pstore) est disponible dans Windows Server 2003 et Windows XP. Il est disponible uniquement pour les opérations en lecture seule dans Windows Server 2008 et Windows Vista, mais peut ne pas être disponible dans les versions ultérieures. Pstore utilise une ancienne implémentation de la protection des données. Les développeurs sont vivement encouragés à tirer parti de la protection des données plus forte fournie par les fonctions CryptProtectData et CryptUnprotectData .]

Écrit un élément de données dans un stockage protégé.

Syntaxe

HRESULT WriteItem(
  [in]        PST_KEY        Key,
  [in]  const GUID           *pItemType,
  [in]  const GUID           *pItemSubtype,
  [in]        LPCWSTR        *szItemName,
  [out]       DWORD          *cbData,
  [out]       BYTE           ppbData,
  [in]        PPST_PROMPTIFO pProomptInfo,
  [in]        DWORD          dwDefaultConfirmationStyle,
  [in]        DWORD          dwFlags
);

Paramètres

Clé [in]

Zone de stockage du fournisseur.

Valeur	Signification
PST_KEY_CURRENT_USER 0x00000000	Le stockage est conservé dans la section utilisateur actuelle du Registre.
PST_KEY_LOCAL_MACHINE 0x00000001	Le stockage est conservé dans la section ordinateur local du Registre.

 

pItemType [in]

Pointeur vers un GUID qui identifie le type de données de l’élément de données en cours d’écriture.

pItemSubtype [in]

Pointeur vers un GUID qui identifie le sous-type de données de l’élément de données en cours d’écriture.

szItemName [in]

Pointeur vers une chaîne qui contient le nom attribué à l’élément de données stocké.

cbData [out]

Pointeur vers un DWORD qui indique la taille de la mémoire tampon qui contient l’élément de données stocké.

ppbData [out]

Pointeur vers une mémoire tampon qui contient l’élément de données en cours d’écriture.

pProomptInfo [in]

Pointeur vers une structure PST_PROMPTINFO .

dwDefaultConfirmationStyle [in]

Style de confirmation par défaut.

Valeur	Signification
PST_CF_DEFAULT 0x00000000	Permet à l’utilisateur de choisir le style de confirmation.
PST_CF_NONE 0x00000001	Force la création d’élément en mode silencieux.

 

dwFlags [in]

L’interface utilisateur et les comportements de sécurité pour l’opération d’écriture.

Valeur	Signification
PST_NO_OVERWRITE 0x00000002	Spécifie que l’élément doit être créé dans le stockage protégé. Le remplacement d’un élément existant n’est pas autorisé.
PST_UNRESTRICTED_ITEMDATA 0x00000004	Spécifie que le flux de données n’est pas sécurisé. Par défaut, les appels d’éléments sont sécurisés.

 

Valeur retournée

La valeur de retour est une valeur HRESULT . La valeur PST_E_OK indique que la fonction a réussi.

Configuration requise

Voir aussi

IPStore

PST_PROMPTINFO