funzione PSPropertyBag_ReadLONG (propsys.h)

Legge un valore di dati LONG da una proprietà in un contenitore di proprietà.

Sintassi

PSSTDAPI PSPropertyBag_ReadLONG(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [out] LONG         *value
);

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: LONG*

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

Valore restituito

Tipo: HRESULT

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

Commenti

Se il contenitore delle proprietà non contiene già la proprietà specificata, la chiamata ha ancora esito positivo.

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

Vedi anche

PSPropertyBag_WriteLONG