IPStore::OpenItem-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.]
Öffnet ein Element für mehrere Zugriffe.
Syntax
HRESULT OpenItem(
[in] PST_KEY Key,
[in] const PSGUID *pItemType,
[in] const GUID *pItemSubtype,
[in] LPCWSTR *szItemName,
[in] PST_ACCESSMODE ModeFlags,
[in] PPST_PROMPTIFO pProomptInfo,
[in] DWORD dwFlags
);
Parameter
-
Schlüssel [in]
-
Gibt an, ob der Typ für den Computer lokal ist oder nur dem erstellenden Benutzer zugeordnet ist.
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 öffnenden Elements identifiziert.
-
pItemSubtype [in]
-
Ein Zeiger auf eine GUID, die den zu öffnenden Elementuntertyp angibt.
-
szItemName [in]
-
Eine Zeichenfolge, die den Namen des zu öffnenden Elements enthält.
-
ModeFlags [in]
-
Beschreibt die Zugriffsmodi, auf die sich ein angegebener Satz von Zugriffsklauseln bezieht. Weitere Informationen finden Sie unter PStore-Typen.
Wert Bedeutung - PST_READ
- 0x0001
Lesezugriffsmodus. - PST_WRITE
- 0x0002
Schreibzugriffsmodus. -
pProomptInfo [in]
-
Ein Zeiger auf eine PST_PROMPTINFO-Struktur .
-
dwFlags [in]
-
Reserviert: muss auf 0 (null) festgelegt werden.
Rückgabewert
Der Rückgabewert ist ein HRESULT-Wert . Der Wert PST_E_OK gibt an, dass die Funktion erfolgreich war.
Bemerkungen
Die Verwendung von OpenItem zum Öffnen eines Elements in der geschützten Speicherdatenbank erfordert, dass es schließlich mithilfe von IPStore::CloseItem geschlossen wird, um einen Speicherverlust zu verhindern.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| DLL |
|
Siehe auch