Метод IPStore::ReadItem

[Защищенное хранилище (Pstore) доступно для использования в Windows Server 2003 и Windows XP. Он доступен только для операций только для чтения в Windows Server 2008 и Windows Vista, но может быть недоступен в последующих версиях. Pstore использует более раннюю реализацию защиты данных. Разработчикам настоятельно рекомендуется воспользоваться преимуществами более надежной защиты данных, предоставляемой функциями CryptProtectData и CryptUnprotectData .]

Считывает указанный элемент данных из защищенного хранилища.

Синтаксис

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

Параметры

Ключ [вход]

Область хранения поставщика.

Значение	Значение
PST_KEY_CURRENT_USER 0x00000000	Хранилище хранится в разделе текущего пользователя реестра.
PST_KEY_LOCAL_MACHINE 0x00000001	Хранилище хранится в разделе реестра на локальном компьютере.

 

pItemType [in]

Указатель на GUID, определяющий тип данных считываемого элемента.

pItemSubtype [in]

Указатель на GUID, определяющий подтип данных считываемого элемента.

szItemName [in]

Указатель на строку, содержащую имя, назначенное хранимому элементу данных.

cbData [in]

DWORD, указывающий размер буфера, содержащего сохраненный элемент данных.

pbData [in]

Указатель на буфер, содержащий сохраненный элемент данных.

pPromptInfo [in]

Указатель на структуру PST_PROMPTINFO .

dwFlags [in]

Задает поведение пользовательского интерфейса и безопасности для операции чтения.

Значения флагов можно комбинировать с логическим ИЛИ.

Значение	Значение
PST_UNRESTRICTED_ITEMDATA 0x00000004	Указывает, что поток данных не является небезопасным. По умолчанию вызовы элементов являются безопасными.
PST_PROMPT_QUERY 0x00000008	Указывает, что подтверждение возвращается после успешного выполнения. Если пользовательский интерфейс включен, возвращается успешное PST_E_OK . Если пользовательский интерфейс не включен, возвращается значение PST_E_ITEM_EXISTS .
PST_NO_UI_MIGRATION 0x00000010	Не показывать пользовательский интерфейс, если не требуется пользовательский пароль.

 

Возвращаемое значение

Возвращаемое значение является значением HRESULT . Значение PST_E_OK указывает, что функция выполнена успешно.

Комментарии

Если ReadItem завершается успешно, приложение отвечает за освобождение возвращенного буфера данных с помощью функции CoTaskMemFree .

Требования

Требование	Значение
Заголовок	Pstore.h
DLL	Pstorec.dll

См. также раздел

IPStore

PST_PROMPTINFO