Метод IPStore::WriteItem

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

Записывает элемент данных в защищенное хранилище.

Синтаксис

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

Параметры

Ключ [вход]

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

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

 

pItemType [in]

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

pItemSubtype [in]

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

szItemName [in]

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

cbData [out]

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

ppbData [out]

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

pProomptInfo [in]

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

dwDefaultConfirmationStyle [in]

Стиль подтверждения по умолчанию.

Значение	Значение
PST_CF_DEFAULT 0x00000000	Позволяет пользователю выбрать стиль подтверждения.
PST_CF_NONE 0x00000001	Принудительное создание элемента в автоматическом режиме.

 

dwFlags [in]

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

Значение	Значение
PST_NO_OVERWRITE 0x00000002	Указывает, что элемент будет создан в защищенном хранилище. Перезапись существующего элемента запрещена.
PST_UNRESTRICTED_ITEMDATA 0x00000004	Указывает, что поток данных не является небезопасным. По умолчанию вызовы элементов являются безопасными.

 

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

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

Требования

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

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

IPStore

PST_PROMPTINFO