Metode IPStore::ReadItem

Artikel
06/13/2023

[Protected Storage (Pstore) tersedia untuk digunakan di Windows Server 2003 dan Windows XP. Ini hanya tersedia untuk operasi baca-saja di Windows Server 2008 dan Windows Vista, tetapi mungkin tidak tersedia dalam versi berikutnya. Pstore menggunakan implementasi perlindungan data yang lebih lama. Pengembang sangat didorong untuk memanfaatkan perlindungan data yang lebih kuat yang disediakan oleh fungsi CryptProtectData dan CryptUnprotectData .]

Membaca item data yang ditentukan dari penyimpanan yang dilindungi.

Sintaks

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

Parameter

Kunci [in]

Area penyimpanan penyedia.

Nilai	Makna
PST_KEY_CURRENT_USER 0x00000000	Penyimpanan dipertahankan di bagian pengguna registri saat ini.
PST_KEY_LOCAL_MACHINE 0x00000001	Penyimpanan dipertahankan di bagian komputer lokal registri.

pItemType [in]

Penunjuk ke GUID yang mengidentifikasi jenis data item yang akan dibaca.

pItemSubtype [in]

Penunjuk ke GUID yang mengidentifikasi subjenis data item yang akan dibaca.

szItemName [in]

Penunjuk ke string yang berisi nama yang ditetapkan ke item data yang disimpan.

cbData [in]

DWORD yang menunjukkan ukuran buffer yang berisi item data yang disimpan.

pbData [in]

Penunjuk ke buffer yang berisi item data yang disimpan.

pPromptInfo [in]

Penunjuk ke struktur PST_PROMPTINFO .

dwFlags [in]

Menentukan antarmuka pengguna dan perilaku keamanan untuk operasi baca.

Nilai bendera dapat dikombinasikan dengan OR logis.

Nilai	Makna
PST_UNRESTRICTED_ITEMDATA 0x00000004	Menentukan bahwa aliran data tidak aman. Secara default, panggilan item aman.
PST_PROMPT_QUERY 0x00000008	Menentukan bahwa konfirmasi dikembalikan setelah berhasil. Jika antarmuka pengguna diaktifkan, keberhasilan PST_E_OK dikembalikan. Jika antarmuka pengguna tidak diaktifkan, nilai PST_E_ITEM_EXISTS dikembalikan.
PST_NO_UI_MIGRATION 0x00000010	Jangan tampilkan antarmuka pengguna kecuali diperlukan kata sandi kustom.

Nilai kembali

Nilai yang dikembalikan adalah nilai HRESULT . Nilai PST_E_OK menunjukkan fungsi berhasil.

Keterangan

Jika ReadItem berhasil diselesaikan, aplikasi bertanggung jawab untuk membebaskan buffer data yang dikembalikan menggunakan fungsi CoTaskMemFree .

Persyaratan

Persyaratan	Nilai
Header	Pstore.h
DLL	Pstorec.dll

Lihat juga

IPStore
PST_PROMPTINFO

Bagikan melalui