MÉTHODE IPStore::ReadItem

[Le stockage protégé (Pstore) est disponible pour une utilisation 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 être indisponible dans les versions suivantes. 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 d’un 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é [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 à lire.

pItemSubtype [in]

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

szItemName [in]

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

cbData [in]

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

pbData [in]

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

pPromptInfo [in]

Pointeur vers une structure PST_PROMPTINFO .

dwFlags [in]

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

Les valeurs d’indicateur peuvent être combinées avec une OR logique.

Valeur	Signification
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.
PST_PROMPT_QUERY 0x00000008	Spécifie que la confirmation doit être retournée en cas de réussite. Si l’interface utilisateur est activée, une réussite de PST_E_OK est retournée. Si l’interface utilisateur n’est pas activée, la valeur PST_E_ITEM_EXISTS est retournée.
PST_NO_UI_MIGRATION 0x00000010	N’affichez 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.

Notes

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

Spécifications

Voir aussi

IPStore

PST_PROMPTINFO