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 von der Windows Storage Management-API abgelöst.]
Erstellt eine Portalgruppe. Der Schnittstellenzeiger für das neue Portalgruppenobjekt kann abgerufen werden, indem IVdsAsync::Wait through the ppAsync parameter aufgerufen wird. Die zurückgegebene VDS_ASYNC_OUTPUT Struktur enthält den Volumeobjektschnittstellenzeiger im cpg.pPortalGroupUnk-Element .
Syntax
HRESULT CreatePortalGroup(
[out] IVdsAsync **ppAsync
);
Die Parameter
[out] ppAsync
Die Adresse eines IVdsAsync-Schnittstellenzeigers , der VDS beim Zurückgeben initialisiert. Aufrufer müssen die Schnittstelle freigeben. Verwenden Sie diese Schnittstelle, um den Status des Vorgangs abzubrechen, zu warten oder abzufragen. Wenn Sie die IVdsAsync::Wait-Methode für diese Schnittstelle aufrufen und ein HRESULT-Erfolgswert zurückgegeben wird, müssen Sie die in der VDS_ASYNC_OUTPUT Struktur zurückgegebenen Schnittstellen freigeben, indem Sie die IUnknown::Release-Methode für jeden Schnittstellenzeiger aufrufen. Wenn Wait jedoch einen HRESULT-Fehlerwert zurückgibt oder wenn der pHrResult-Parameter von Wait einen HRESULT-Fehlerwert empfängt, sind die Schnittstellenzeiger in der VDS_ASYNC_OUTPUT-StrukturNULL und müssen nicht freigegeben werden. Sie können die HRESULT-Werte für Erfolg oder Fehler testen, indem Sie die in "Winerror.h" definierten Makros "SUCCEEDED " und "FAILED " verwenden.
Rückgabewert
Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Sie kann auch konvertierte Systemfehlercodes mithilfe des HRESULT_FROM_WIN32 Makros zurückgeben. Fehler können von VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Mögliche Rückgabewerte sind:
| Zurückgeben von Code/Wert | Description |
|---|---|
|
Die Portalgruppe wurde erfolgreich erstellt. |
|
Es können keine weiteren Portalgruppen erstellt werden. Die CreatePortalGroup-Methode hat keine neue Portalgruppe erstellt. Wenn Sie die IVdsAsync::Wait-Methode für den Schnittstellenzeiger aufrufen, der im ppAsync-Parameter zurückgegeben wird, wird ein vorhandenes Portalgruppenobjekt abgerufen. |
|
Der Cache des Anbieters ist beschädigt. Dies weist auf ein Software- oder Kommunikationsproblem innerhalb eines Anbieters hin, der Informationen über die angeschlossenen Geräte zwischenspeichert. Der Aufrufer kann die IVdsHwProvider::Reenumerate-Methode gefolgt von der IVdsHwProvider::Refresh-Methode verwenden, um den Cache wiederherzustellen. |
|
Das Zielobjekt ist nicht mehr vorhanden. |
|
Ein weiterer Vorgang wird ausgeführt; Dieser Vorgang kann erst fortgesetzt werden, wenn die vorherigen Vorgänge abgeschlossen sind. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client | Windows Vista [nur Desktop-Apps] |
| Mindestanforderungen für unterstützte Server | Windows Server 2003 R2 [nur Desktop-Apps] |
| Zielplattform | Fenster |
| Header | vds.h |
| Library | Uuid.lib |
| Weiterverteilbar | VDS 1.1 |