IPStore :: ReadItem, 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 .]

Lit l’élément de données spécifié à partir du stockage protégé.

Syntaxe

HRESULT ReadItem(
  [in]       PST_KEY        Key,
  [in] const PSGUID         *pItemType,
  [in] const GUID           *pItemSubtype,
  [in]       LPCWSTR        *szItemName,
  [in]       DWORD          cbData,
  [in]       BYTE_RPC_FAR   *pbData,
  [in]       PPST_PROMPTIFO pPromptInfo,
  [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 à lire.

pItemSubtype [ dans]

Pointeur vers un GUID qui identifie le sous-type de données de l’élément à lire.

szItemName [ dans]

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

cbData [ dans]

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

pbData [ dans]

Pointeur vers une mémoire tampon qui contient l’élément de données stockées.

pPromptInfo [ dans]

Pointeur vers une structure _ PROMPTINFO PST .

dwFlags [ dans]

Spécifie l’interface utilisateur et les comportements de sécurité pour l’opération de lecture.

Les valeurs d’indicateur peuvent être combinées avec un opérateur logique OR.

Valeur Signification
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.
Fichier PST _ INVITE de _ requête
0x00000008
Spécifie que la confirmation doit être retournée en cas de réussite. Si l’interface utilisateur est activée, la réussite du fichier PST _ E _ OK est retournée. Si l’interface utilisateur n’est pas activée, la valeur de l' _ _ élément _ PST E est retournée.
Fichier PST _ AUCUNE _ _ migration de l’interface utilisateur
0x00000010
N’affiche pas l’interface utilisateur, sauf si un mot de passe personnalisé est requis.

Valeur retournée

La valeur de retour est une valeur HRESULT . La valeur PST _ E _ OK indique que la fonction a réussi.

Remarques

Si ReadItem se termine correctement, l’application est chargée de libérer la mémoire tampon de données retournée à l’aide de la fonction CoTaskMemFree .

Configuration requise

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

Voir aussi

IPStore

_PROMPTINFO PST