funzione PSPropertyBag_ReadStrAlloc (propsys.h)

Articolo
03/13/2024

Legge un valore di dati stringa da una proprietà in un contenitore di proprietà e alloca la memoria per la stringa che viene letta.

Sintassi

PSSTDAPI PSPropertyBag_ReadStrAlloc(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [out] PWSTR        *value
);

Parametri

[in] propBag

Tipo: IPropertyBag*

Puntatore a un oggetto IPropertyBag che rappresenta il contenitore delle proprietà in cui è archiviata la proprietà .

[in] propName

Tipo: LPCWSTR

Puntatore a una stringa di nome di proprietà con terminazione Null.

[out] value

Tipo: PWSTR*

Quando questa funzione viene restituita, contiene un puntatore a un valore di dati stringa da una proprietà in un contenitore di proprietà e alloca la memoria per la stringa letta. Il chiamante della funzione PSPropertyBag_ReadStrAlloc deve chiamare una funzione CoTaskMemFree su questo parametro.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

L'API della funzione della proprietà contenitore delle proprietà converte tra i tipi di finestra e il tipo VARIANT usato per esprimere i valori in un contenitore delle proprietà. In questo modo è possibile semplificare l'utilizzo del contenitore delle proprietà, semplificare le applicazioni ed evitare errori di codifica comuni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	propsys.h
Libreria	Propsys.lib
DLL	Propsys.dll (versione 6.0 o successiva)

Condividi tramite