Metodo IPStore::WriteItem

Articolo
06/13/2023

[Archiviazione protetta (Pstore) è disponibile per l'uso in Windows Server 2003 e Windows XP. È disponibile solo per operazioni di sola lettura in Windows Server 2008 e Windows Vista, ma potrebbero non essere disponibili 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.

Scrive un elemento di dati nell'archiviazione protetta.

Sintassi

HRESULT WriteItem(
  [in]        PST_KEY        Key,
  [in]  const GUID           *pItemType,
  [in]  const GUID           *pItemSubtype,
  [in]        LPCWSTR        *szItemName,
  [out]       DWORD          *cbData,
  [out]       BYTE           ppbData,
  [in]        PPST_PROMPTIFO pProomptInfo,
  [in]        DWORD          dwDefaultConfirmationStyle,
  [in]        DWORD          dwFlags
);

Parametri

Chiave [in]

Area di archiviazione del provider.

Valore	Significato
PST_KEY_CURRENT_USER 0x00000000	L'archiviazione viene mantenuta nella sezione utente corrente del Registro di sistema.
PST_KEY_LOCAL_MACHINE 0x00000001	L'archiviazione viene gestita nella sezione computer locale del Registro di sistema.

pItemType [in]

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

pItemSubtype [in]

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

szItemName [in]

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

cbData [out]

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

ppbData [out]

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

pProomptInfo [in]

Puntatore a una struttura PST_PROMPTINFO .

dwDefaultConfirmationStyle [in]

Stile di conferma predefinito.

Valore	Significato
PST_CF_DEFAULT 0x00000000	Consente all'utente di scegliere lo stile di conferma.
PST_CF_NONE 0x00000001	Forza la creazione di elementi invisibile all'utente.

dwFlags [in]

Interfaccia utente e comportamenti di sicurezza per l'operazione di scrittura.

Valore	Significato
PST_NO_OVERWRITE 0x00000002	Specifica che l'elemento viene creato nell'archiviazione protetta. La sovrascrittura di un elemento esistente non è consentita.
PST_UNRESTRICTED_ITEMDATA 0x00000004	Specifica che il flusso di dati non è sicuro. Per impostazione predefinita, le chiamate di elemento sono sicure.

Valore restituito

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

Requisiti

Requisito	Valore
Intestazione	Pstore.h
DLL	Pstorec.dll

Vedi anche

IPStore
PST_PROMPTINFO

Condividi tramite