Método IPStore::OpenItem
[O Armazenamento Protegido (Pstore) está disponível para uso no Windows Server 2003 e no Windows XP. Ele só está disponível para operações somente leitura no Windows Server 2008 e no Windows Vista, mas pode estar indisponível nas versões subsequentes. O Pstore usa uma implementação mais antiga da proteção de dados. Os desenvolvedores são altamente incentivados a aproveitar a proteção de dados mais forte fornecida pelas funções CryptProtectData e CryptUnprotectData .]
Abre um item para vários acessos.
Sintaxe
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
);
Parâmetros
-
Chave [in]
-
Especifica se o tipo é local para o computador ou associado apenas ao usuário de criação.
Valor Significado - PST_KEY_CURRENT_USER
- 0x00000000
O armazenamento é mantido na seção de usuário atual do registro. - PST_KEY_LOCAL_MACHINE
- 0x00000001
O armazenamento é mantido na seção computador local do registro. -
pItemType [in]
-
Um ponteiro para um GUID que identifica o tipo de dados do item a ser aberto.
-
pItemSubtype [in]
-
Um ponteiro para um GUID que indica o subtipo de item a ser aberto.
-
szItemName [in]
-
Uma cadeia de caracteres que contém o nome do item a ser aberto.
-
ModeFlags [in]
-
Descreve os modos de acesso aos quais um conjunto especificado de cláusulas de acesso pertence. Para obter mais informações, consulte Tipos de PStore.
Valor Significado - PST_READ
- 0x0001
Modo de acesso de leitura. - PST_WRITE
- 0x0002
Modo de acesso de gravação. -
pProomptInfo [in]
-
Um ponteiro para uma estrutura de PST_PROMPTINFO .
-
dwFlags [in]
-
Reservado: deve ser definido como zero.
Valor retornado
O valor retornado é um valor HRESULT . Um valor de PST_E_OK indica que a função foi bem-sucedida.
Comentários
O uso do OpenItem para abrir um item no banco de dados de armazenamento protegido requer que ele seja fechado usando IPStore::CloseItem para evitar um vazamento de memória.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| DLL |
|
Confira também