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 |
|
| DLL |
|