Metodo IPStore::ReadItem

[Archiviazione protetta (Pstore) è disponibile per l'uso in Windows Server 2003 e Windows XP. È disponibile solo per le operazioni di sola lettura in Windows Server 2008 e Windows Vista, ma potrebbe non essere disponibile nelle versioni successive. Pstore usa un'implementazione precedente della protezione dei dati. Gli sviluppatori sono fortemente invitati a sfruttare la protezione dei dati più avanzata fornita dalle funzioni CryptProtectData e CryptUnprotectData .

Legge l'elemento di dati specificato dall'archiviazione protetta.

Sintassi

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
);

Parametri

Chiave [in]

Area di archiviazione del provider.

Valore	Significato
PST_KEY_CURRENT_USER 0x00000000	Lo spazio di archiviazione viene mantenuto nella sezione utente corrente del Registro di sistema.
PST_KEY_LOCAL_MACHINE 0x00000001	Lo spazio di archiviazione viene mantenuto nella sezione computer locale del Registro di sistema.

 

pItemType [in]

Puntatore a un GUID che identifica il tipo di dati dell'elemento da leggere.

pItemSubtype [in]

Puntatore a un GUID che identifica il sottotipo di dati dell'elemento da leggere.

szItemName [in]

Puntatore a una stringa contenente il nome assegnato all'elemento di dati archiviato.

cbData [in]

DWORD che indica le dimensioni del buffer che contiene l'elemento di dati archiviato.

pbData [in]

Puntatore a un buffer contenente l'elemento di dati archiviato.

pPromptInfo [in]

Puntatore a una struttura PST_PROMPTINFO .

dwFlags [in]

Specifica i comportamenti di sicurezza e dell'interfaccia utente per l'operazione di lettura.

I valori del flag possono essere combinati con un OR logico.

Valore	Significato
PST_UNRESTRICTED_ITEMDATA 0x00000004	Specifica che il flusso di dati non è sicuro. Per impostazione predefinita, le chiamate agli elementi sono sicure.
PST_PROMPT_QUERY 0x00000008	Specifica che la conferma deve essere restituita al completamento dell'operazione. Se l'interfaccia utente è abilitata, viene restituita l'esito positivo di PST_E_OK . Se l'interfaccia utente non è abilitata, viene restituito un valore di PST_E_ITEM_EXISTS .
PST_NO_UI_MIGRATION 0x00000010	Non visualizzare l'interfaccia utente a meno che non sia necessaria una password personalizzata.

 

Valore restituito

Il valore restituito è un valore HRESULT . Un valore di PST_E_OK indica che la funzione ha avuto esito positivo.

Commenti

Se ReadItem viene completato correttamente, l'applicazione è responsabile della liberazione del buffer di dati restituito tramite la funzione CoTaskMemFree .

Requisiti

Requisito	Valore
Intestazione	Pstore.h
DLL	Pstorec.dll

Vedi anche

IPStore

PST_PROMPTINFO