Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API abgelöst.]
Gibt die Eigenschaften des angegebenen Controllerports zurück.
Syntax
HRESULT GetPortProperties(
[in] SHORT sPortNumber,
[out] VDS_PORT_PROP *pPortProp
);
Parameter
[in] sPortNumber
Die Nummer des Ports. Portnummern sind dauerhaft. Ports werden von 0 nummeriert.
[out] pPortProp
Die Adresse einer VDS_PORT_PROP Struktur, die vom Aufrufer zugewiesen und übergeben wird. VDS weist Arbeitsspeicher für die Memberzeichenfolgen pwszFriendlyName und pwszIdentification zu. Aufrufer müssen die Zeichenfolgen mithilfe der CoTaskMemFree-Funktion freigeben.
Rückgabewert
Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Es kann auch konvertierte Systemfehlercodes mithilfe des makros HRESULT_FROM_WIN32 zurückgeben. Fehler können vom VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Folgende Rückgabewerte sind möglich.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Dieser Rückgabewert signalisiert ein Software- oder Kommunikationsproblem innerhalb eines Anbieters, der Informationen über das Array zwischenspeichert. Verwenden Sie die IVdsHwProvider::Reenumerate-Methode gefolgt von der IVdsHwProvider::Refresh-Methode , um den Cache wiederherzustellen. |
|
Das Controllerobjekt ist nicht mehr vorhanden. |
|
Dieser Vorgang oder eine Kombination von Parametern wird von diesem Anbieter nicht unterstützt. |
Hinweise
Verwenden Sie die IVdsController::GetProperties-Methode , um die Gesamtzahl der Ports abzurufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vds.h |
| Bibliothek | Uuid.lib |