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 |