IPropertyStore::GetCount-Methode (propsys.h)

Diese Methode gibt eine Anzahl der Eigenschaften zurück, die der Datei angefügt sind.

Syntax

HRESULT GetCount(
  DWORD *cProps
);

Parameter

cProps

Ein Zeiger auf einen Wert, der die Eigenschaftsanzahl angibt.

Rückgabewert

Die IpropertyStore::GetCount -Methode gibt den Wert S_OK zurück, wenn der Aufruf erfolgreich ist, auch wenn die Datei keine Eigenschaften angefügt hat. Jeder andere zurückgegebene Code ist ein Fehlercode.

Hinweise

IPropertyStore stellt eine Abstraktion über ein Array von Eigenschaftenschlüsseln über die IPropertyStore::GetCountIPropertyStore::GetAt-Methoden und bereit. Die Eigenschaftenschlüssel in diesem Array stellen die Eigenschaften dar, die derzeit vom IPropertyStore gespeichert werden.

Wenn GetCount dies erfolgreich ist, ist der Wert, auf den von cProps verwiesen wird, eine Anzahl von Eigenschaftenschlüsseln im Array. Der Aufrufer kann erwarten, dass Aufrufe von IPropertyStore::GetAt für Werte von iProp kleiner als cProps erfolgreich sind.

Bei Fehlern wie E_OUTOFMEMORY sollten Sie cProps auf Null festlegen. Es ist vorzuziehen, dass Fehler beim Erstellen oder Initialisieren des Eigenschaftenspeichers erkannt werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar mit Windows Vista und höheren Versionen des Windows-Betriebssystems.
Zielplattform Universell
Header propsys.h
Bibliothek Propsys.idl
IRQL Alle Ebenen

Weitere Informationen

Ipropertystore

IPropertyStore::GetAt