funzione PSPropertyBag_ReadStr (propsys.h)

Legge il valore dei dati stringa di una proprietà in un contenitore di proprietà.

Sintassi

PSSTDAPI PSPropertyBag_ReadStr(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [out] LPWSTR       value,
  [out] int          characterCount
);

Parametri

[in] propBag

Tipo: IPropertyBag*

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

[in] propName

Tipo: LPCWSTR

Stringa del nome della proprietà con terminazione null.

[out] value

Tipo: LPCWSTR

Quando questa funzione restituisce, contiene un puntatore a un valore di proprietà stringa.

[out] characterCount

Tipo: int

Questa funzione restituisce l'intero che rappresenta la dimensione (numero massimo di caratteri) del parametro valore restituito.

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à bag delle proprietà converte tra i tipi di finestra e il tipo VARIANT utilizzato 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)

Vedi anche

PSPropertyBag_WriteStr