Método IPStore::WriteItem

Artigo
06/13/2023

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

Grava um item de dados no armazenamento protegido.

Sintaxe

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

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 do computador local do registro.

pItemType [in]

Um ponteiro para um GUID que identifica o tipo de dados do item de dados que está sendo gravado.

pItemSubtype [in]

Um ponteiro para um GUID que identifica o subtipo de dados do item de dados que está sendo gravado.

szItemName [in]

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

cbData [out]

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

ppbData [out]

Um ponteiro para um buffer que contém o item de dados que está sendo gravado.

pProomptInfo [in]

Ponteiro para uma estrutura PST_PROMPTINFO .

dwDefaultConfirmationStyle [in]

O estilo de confirmação padrão.

Valor	Significado
PST_CF_DEFAULT 0x00000000	Permite que o usuário escolha o estilo de confirmação.
PST_CF_NONE 0x00000001	Força a criação de itens silenciosos.

dwFlags [in]

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

Valor	Significado
PST_NO_OVERWRITE 0x00000002	Especifica que o item seja criado no armazenamento protegido. A substituição de um item existente não é permitida.
PST_UNRESTRICTED_ITEMDATA 0x00000004	Especifica que o fluxo de dados não é seguro. Por padrão, as chamadas de item são seguras.

Valor retornado

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

Requisitos

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

Confira também

IPStore
PST_PROMPTINFO

Compartilhar via