Freigeben über


IPStore::WriteItem-Methode

[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