IPStore :: WriteItem, méthode

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

Écrit un élément de données dans le 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é [ dans]

Zone de stockage du fournisseur.

Valeur Signification
Fichier PST _ _ _ Utilisateur actuel
0x00000000
Le stockage est conservé dans la section utilisateur actuel du Registre.
Fichier PST _ _ _ Ordinateur local
de la clé
0x00000001
Le stockage est conservé dans la section ordinateur local du Registre.

pItemType [ dans]

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

pItemSubtype [ dans]

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

szItemName [ dans]

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

cbData [ à]

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

ppbData [ à]

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

pProomptInfo [ dans]

Pointeur vers une structure _ PROMPTINFO PST .

dwDefaultConfirmationStyle [ dans]

Style de confirmation par défaut.

Valeur Signification
Fichier PST _ CF _ par défaut
0x00000000
Permet à l’utilisateur de choisir le style de confirmation.
Fichier PST _ CF _ aucun
0x00000001
Force la création d’un élément silencieux.

dwFlags [ dans]

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

Valeur Signification
Fichier PST _ AUCUN _ remplacement
0x00000002
Spécifie que l’élément doit être créé dans un stockage protégé. Le remplacement d’un élément existant n’est pas autorisé.
Fichier PST _ _ITEMDATA
0x00000004
non restreint
Spécifie que le flux de données n’est pas sécurisé. Par défaut, les appels d’élément 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

Condition requise Valeur
En-tête
Pstore. h
DLL
Pstorec.dll

Voir aussi

IPStore

_PROMPTINFO PST