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 |
|
DLL |
|
Siehe auch