Metodo IPropertyStore::GetCount (propsys.h)

Questo metodo restituisce un conteggio del numero di proprietà associate al file.

Sintassi

HRESULT GetCount(
  DWORD *cProps
);

Parametri

cProps

Puntatore a un valore che indica il conteggio delle proprietà.

Valore restituito

Il IpropertyStore::GetCount metodo restituisce un valore di S_OK quando la chiamata ha esito positivo, anche se il file non dispone di proprietà associate. Qualsiasi altro codice restituito è un codice di errore.

Commenti

IPropertyStore fornisce un'astrazione su una matrice di chiavi di proprietà tramite i IPropertyStore::GetCount metodi e IPropertyStore::GetAt . Le chiavi delle proprietà in questa matrice rappresentano le proprietà attualmente archiviate da IPropertyStore.

Quando GetCount ha esito positivo, il valore a cui punta cProps è un conteggio delle chiavi di proprietà nella matrice. Il chiamante può prevedere che le chiamate a IPropertyStore::GetAt abbiano esito positivo per i valori di iProp inferiori a cProps.

In caso di errori come E_OUTOFMEMORY, è necessario impostare cProps su zero. È preferibile che durante la creazione o l'inizializzazione dell'archivio delle proprietà vengano individuati errori.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile con Windows Vista e versioni successive del sistema operativo Windows.
Piattaforma di destinazione	Universale
Intestazione	propsys.h
Libreria	Propsys.idl
IRQL	Tutti i livelli

Vedi anche

Ipropertystore

IPropertyStore::GetAt