MÉTHODE IPStore::OpenItem

[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 .]

Ouvre un élément pour plusieurs accès.

Syntaxe

HRESULT OpenItem(
  [in]       PST_KEY        Key,
  [in] const PSGUID         *pItemType,
  [in] const GUID           *pItemSubtype,
  [in]       LPCWSTR        *szItemName,
  [in]       PST_ACCESSMODE ModeFlags,
  [in]       PPST_PROMPTIFO pProomptInfo,
  [in]       DWORD          dwFlags
);

Paramètres

Clé [in]

Spécifie si le type est local sur l’ordinateur ou associé uniquement à l’utilisateur qui crée.

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 à ouvrir.

pItemSubtype [in]

Pointeur vers un GUID qui indique le sous-type d’élément à ouvrir.

szItemName [in]

Chaîne qui contient le nom de l’élément à ouvrir.

ModeFlags [in]

Décrit les modes d’accès auxquels se rapporte un ensemble spécifié de clauses d’accès. Pour plus d’informations, consultez Types PStore.

Valeur	Signification
PST_READ 0x0001	Mode d’accès en lecture.
PST_WRITE 0x0002	Mode d’accès en écriture.

 

pProomptInfo [in]

Pointeur vers une structure PST_PROMPTINFO .

dwFlags [in]

Réservé : doit être défini sur zéro.

Valeur retournée

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

Notes

L’utilisation d’OpenItem pour ouvrir un élément dans la base de données de stockage protégée nécessite sa fermeture à l’aide d’IPStore::CloseItem pour éviter une fuite de mémoire.

Spécifications

Voir aussi

IPStore

PST_PROMPTINFO