IPStore::WriteItem-Methode

Artikel
06/13/2023

[Geschützter Speicher (Pstore) ist für die Verwendung in Windows Server 2003 und Windows XP verfügbar. Es ist nur für schreibgeschützte Vorgänge in Windows Server 2008 und Windows Vista verfügbar, ist aber in nachfolgenden Versionen möglicherweise nicht verfügbar. Pstore verwendet eine ältere Implementierung des Datenschutzes. Entwicklern wird dringend empfohlen, den stärkeren Datenschutz zu nutzen, den die Funktionen CryptProtectData und CryptUnprotectData bietet.]

Schreibt ein Datenelement in den geschützten Speicher.

Syntax

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

Parameter

Schlüssel [in]

Der Speicherbereich des Anbieters.

Wert	Bedeutung
PST_KEY_CURRENT_USER 0x00000000	Der Speicher wird im aktuellen Benutzerabschnitt der Registrierung verwaltet.
PST_KEY_LOCAL_MACHINE 0x00000001	Der Speicher wird im Lokalen Computerabschnitt der Registrierung verwaltet.

pItemType [in]

Ein Zeiger auf eine GUID , die den Datentyp des zu schreibenden Datenelements identifiziert.

pItemSubtype [in]

Ein Zeiger auf eine GUID , die den Datenuntertyp des zu schreibenden Datenelements identifiziert.

szItemName [in]

Ein Zeiger auf eine Zeichenfolge, die den Namen enthält, der dem gespeicherten Datenelement zugewiesen ist.

cbData [out]

Ein Zeiger auf ein DWORD , der die Größe des Puffers angibt, der das gespeicherte Datenelement enthält.

ppbData [out]

Ein Zeiger auf einen Puffer, der das zu schreibende Datenelement enthält.

pProomptInfo [in]

Zeiger auf eine PST_PROMPTINFO-Struktur .

dwDefaultConfirmationStyle [in]

Der Standardbestätigungsstil.

Wert	Bedeutung
PST_CF_DEFAULT 0x00000000	Ermöglicht dem Benutzer die Auswahl des Bestätigungsstils.
PST_CF_NONE 0x00000001	Erzwingt die automatische Elementerstellung.

dwFlags [in]

Die Benutzeroberfläche und das Sicherheitsverhalten für den Schreibvorgang.

Wert	Bedeutung
PST_NO_OVERWRITE 0x00000002	Gibt an, dass das Element im geschützten Speicher erstellt wird. Das Überschreiben eines vorhandenen Elements ist nicht zulässig.
PST_UNRESTRICTED_ITEMDATA 0x00000004	Gibt an, dass der Datenstrom nicht sicher ist. Standardmäßig sind Elementaufrufe sicher.

Rückgabewert

Der Rückgabewert ist ein HRESULT-Wert . Der Wert PST_E_OK gibt an, dass die Funktion erfolgreich war.

Anforderungen

Anforderung	Wert
Header	Pstore.h
DLL	Pstorec.dll

Siehe auch

IPStore
PST_PROMPTINFO

Freigeben über