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

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é [ dans]

Spécifie si le type est local sur l’ordinateur ou s’il est associé uniquement à l’utilisateur en train de créer.

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

pItemSubtype [ dans]

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

szItemName [ dans]

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

ModeFlags [ dans]

Décrit les modes d’accès auxquels appartient un ensemble spécifié de clauses d’accès. Pour plus d’informations, consultez types Pstore.

Valeur Signification
Fichier PST _ LIRE
0x0001
Mode d’accès en lecture.
Fichier PST _ ÉCRIRE
0x0002
Mode d’accès en écriture.

pProomptInfo [ dans]

Pointeur vers une structure _ PROMPTINFO PST .

dwFlags [ dans]

Réservé : doit être défini à 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 de OpenItem pour ouvrir un élément dans la base de données de stockage protégée requiert qu’il soit fermé à l’aide de IPStore :: CloseItem pour empêcher une fuite de mémoire.

Configuration requise

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

Voir aussi

IPStore

_PROMPTINFO PST