Método IPStore::ReadItem

[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 .]

Lê o item de dados especificado do armazenamento protegido.

Sintaxe

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

Parâmetros

Chave [in]

A área de armazenamento do provedor.

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 lido.

pItemSubtype [in]

Um ponteiro para um GUID que identifica o subtipo de dados do item a ser lido.

szItemName [in]

Um ponteiro para uma cadeia de caracteres que contém o nome atribuído ao item de dados armazenado.

cbData [in]

Um DWORD que indica o tamanho do buffer que contém o item de dados armazenado.

pbData [in]

Um ponteiro para um buffer que contém o item de dados armazenado.

pPromptInfo [in]

Um ponteiro para uma estrutura de PST_PROMPTINFO .

dwFlags [in]

Especifica a interface do usuário e os comportamentos de segurança para a operação de leitura.

Os valores de sinalizador podem ser combinados com um OR lógico.

Valor	Significado
PST_UNRESTRICTED_ITEMDATA 0x00000004	Especifica que o fluxo de dados não é seguro. Por padrão, as chamadas de item são seguras.
PST_PROMPT_QUERY 0x00000008	Especifica que a confirmação seja retornada após o êxito. Se a interface do usuário estiver habilitada, um sucesso de PST_E_OK será retornado. Se a interface do usuário não estiver habilitada, um valor de PST_E_ITEM_EXISTS será retornado.
PST_NO_UI_MIGRATION 0x00000010	Não mostre a interface do usuário, a menos que uma senha personalizada seja necessária.

 

Valor retornado

O valor retornado é um valor HRESULT . Um valor de PST_E_OK indica que a função foi bem-sucedida.

Comentários

Se ReadItem for concluído com êxito, o aplicativo será responsável por liberar o buffer de dados retornado usando a função CoTaskMemFree .

Requisitos

Requisito	Valor
parâmetro	Pstore.h
DLL	Pstorec.dll

Confira também

IPStore

PST_PROMPTINFO