Método IPStore::WriteItem

[Almacenamiento protegido (Pstore) está disponible para su uso en Windows Server 2003 y Windows XP. Solo está disponible para las operaciones de solo lectura en Windows Server 2008 y Windows Vista, pero puede no estar disponible en versiones posteriores. Pstore usa una implementación anterior de la protección de datos. Se recomienda encarecidamente a los desarrolladores aprovechar la protección de datos más sólida proporcionada por las funciones CryptProtectData y CryptUnprotectData .

Escribe un elemento de datos en el almacenamiento protegido.

Sintaxis

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

Parámetros

Clave [in]

El área de almacenamiento del proveedor.

Value	Significado
PST_KEY_CURRENT_USER 0x00000000	El almacenamiento se mantiene en la sección de usuario actual del Registro.
PST_KEY_LOCAL_MACHINE 0x00000001	El almacenamiento se mantiene en la sección máquina local del Registro.

 

pItemType [in]

Puntero a un GUID que identifica el tipo de datos del elemento de datos que se está escribiendo.

pItemSubtype [in]

Puntero a un GUID que identifica el subtipo de datos del elemento de datos que se está escribiendo.

szItemName [in]

Puntero a una cadena que contiene el nombre asignado al elemento de datos almacenado.

cbData [out]

Puntero a un DWORD que indica el tamaño del búfer que contiene el elemento de datos almacenado.

ppbData [out]

Puntero a un búfer que contiene el elemento de datos que se está escribiendo.

pProomptInfo [in]

Puntero a una estructura de PST_PROMPTINFO .

dwDefaultConfirmationStyle [in]

Estilo de confirmación predeterminado.

Value	Significado
PST_CF_DEFAULT 0x00000000	Permite al usuario elegir el estilo de confirmación.
PST_CF_NONE 0x00000001	Fuerza la creación silenciosa de elementos.

 

dwFlags [in]

Interfaz de usuario y comportamientos de seguridad para la operación de escritura.

Value	Significado
PST_NO_OVERWRITE 0x00000002	Especifica que el elemento que se va a crear en el almacenamiento protegido. No se permite sobrescribir un elemento existente.
PST_UNRESTRICTED_ITEMDATA 0x00000004	Especifica que el flujo de datos no es seguro. De forma predeterminada, las llamadas de elemento son seguras.

 

Valor devuelto

El valor devuelto es un valor HRESULT . Un valor de PST_E_OK indica que la función se realizó correctamente.

Requisitos

Consulte también

IPStore

PST_PROMPTINFO