IVdsServiceIscsi::RememberTargetSharedSecret-Methode (vds.h)
[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]
Kommuniziert das freigegebene CHAP-Geheimnis eines Ziels an den Initiatordienst. Dieses freigegebene Geheimnis wird während der Zielanmeldung verwendet, wenn das Ziel den Initiator authentifiziert.
Syntax
HRESULT RememberTargetSharedSecret(
[in] VDS_OBJECT_ID targetId,
[in] VDS_ISCSI_SHARED_SECRET *pTargetSharedSecret
);
Parameter
[in] targetId
Die VDS_OBJECT_ID des Ziels, das über das angegebene freigegebene Geheimnis verfügt. Dieser Parameter ist erforderlich und kann nicht GUID_NULL werden.
[in] pTargetSharedSecret
Die Adresse einer VDS_ISCSI_SHARED_SECRET-Struktur , die das freigegebene CHAP-Geheimnis enthält.
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 HRESULT_FROM_WIN32-Makros 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 |
|---|---|
|
Das freigegebene Geheimnis wurde erfolgreich gespeichert. |
|
VDS konnte nicht initialisiert werden. Wenn eine Anwendung diese Methode aufruft, bevor der Dienst die Initialisierung abgeschlossen hat, wird die Methode blockiert, bis die Initialisierung abgeschlossen ist. Wenn bei der Initialisierung ein Fehler auftritt, wird dieser Fehler zurückgegeben. |
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vds.h |
| Bibliothek | Uuid.lib |
| Verteilbare Komponente | VDS 1.1 |
Weitere Informationen
IVdsIscsiTarget::RememberInitiatorSharedSecret
IVdsIscsiTarget::SetSharedSecret