Метод IPStore::OpenItem

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

Открывает элемент для нескольких обращений.

Синтаксис

HRESULT OpenItem(
  [in]       PST_KEY        Key,
  [in] const PSGUID         *pItemType,
  [in] const GUID           *pItemSubtype,
  [in]       LPCWSTR        *szItemName,
  [in]       PST_ACCESSMODE ModeFlags,
  [in]       PPST_PROMPTIFO pProomptInfo,
  [in]       DWORD          dwFlags
);

Параметры

Ключ [в]

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

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

 

pItemType [in]

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

pItemSubtype [in]

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

szItemName [in]

Строка, содержащая имя открываемого элемента.

ModeFlags [in]

Описывает режимы доступа, к которым относится указанный набор предложений доступа. Дополнительные сведения см. в разделе Типы PStore.

Значение	Значение
PST_READ 0x0001	Режим доступа на чтение.
PST_WRITE 0x0002	Режим доступа на запись.

 

pProomptInfo [in]

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

dwFlags [in]

Зарезервировано: должно быть равно нулю.

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

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

Комментарии

Использование OpenItem для открытия элемента в защищенной базе данных хранилища требует, чтобы он в конечном итоге был закрыт с помощью IPStore::CloseItem , чтобы предотвратить утечку памяти.

Требования

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

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

IPStore

PST_PROMPTINFO