IPStore::ReadItem-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.]

Liest das angegebene Datenelement aus dem geschützten Speicher.

Syntax

HRESULT ReadItem(
  [in]       PST_KEY        Key,
  [in] const PSGUID         *pItemType,
  [in] const GUID           *pItemSubtype,
  [in]       LPCWSTR        *szItemName,
  [in]       DWORD          cbData,
  [in]       BYTE_RPC_FAR   *pbData,
  [in]       PPST_PROMPTIFO pPromptInfo,
  [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 lesenden Elements identifiziert.

pItemSubtype [in]

Ein Zeiger auf eine GUID, die den Datenuntertyp des zu lesenden Elements identifiziert.

szItemName [in]

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

cbData [in]

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

pbData [in]

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

pPromptInfo [in]

Ein Zeiger auf eine PST_PROMPTINFO-Struktur .

dwFlags [in]

Gibt das Benutzeroberflächen- und Sicherheitsverhalten für den Lesevorgang an.

Die Flagwerte können mit einem logischen OR kombiniert werden.

Wert	Bedeutung
PST_UNRESTRICTED_ITEMDATA 0x00000004	Gibt an, dass der Datenstrom nicht sicher ist. Standardmäßig sind Elementaufrufe sicher.
PST_PROMPT_QUERY 0x00000008	Gibt an, dass die Bestätigung bei Erfolg zurückgegeben wird. Wenn die Benutzeroberfläche aktiviert ist, wird ein erfolgreicher PST_E_OK zurückgegeben. Wenn die Benutzeroberfläche nicht aktiviert ist, wird der Wert PST_E_ITEM_EXISTS zurückgegeben.
PST_NO_UI_MIGRATION 0x00000010	Die Benutzeroberfläche wird nur angezeigt, wenn ein benutzerdefiniertes Kennwort erforderlich ist.

Rückgabewert

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

Bemerkungen

Wenn ReadItem erfolgreich abgeschlossen wurde, ist die Anwendung dafür verantwortlich, den zurückgegebenen Datenpuffer mithilfe der CoTaskMemFree-Funktion freizugeben.

Anforderungen

Anforderung	Wert
Header	Pstore.h
DLL	Pstorec.dll

Siehe auch

IPStore
PST_PROMPTINFO

Freigeben über