IVdsServiceIscsi::SetInitiatorSharedSecret-Methode (vds.h)
[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts von der Windows Storage Management-API abgelöst.]
Legt das freigegebene CHAP-Geheimnis des Initiators fest, das für die gegenseitige CHAP-Authentifizierung verwendet wird, wenn der Initiator das Ziel authentifiziert.
Syntax
HRESULT SetInitiatorSharedSecret(
[in] VDS_ISCSI_SHARED_SECRET *pInitiatorSharedSecret,
[in] VDS_OBJECT_ID targetId
);
Parameter
[in] pInitiatorSharedSecret
Die Adresse einer VDS_ISCSI_SHARED_SECRET Struktur, die das freigegebene Geheimnis enthält. Wenn das pSharedSecret-ElementNULL und ulSharedSecretSize null ist, löscht die SetInitiatorSharedSecret-Methode alle vorhandenen Geheimnisse. Wenn dieser Parameter NULL ist und der TargetId-Parameter nicht GUID_NULL ist, löscht SetInitiatorSharedSecret die Zuordnung zwischen dem Initiator und dem Ziel.
[in] targetId
Die VDS_OBJECT_ID des Ziels. Dieser Parameter ist auf GUID_NULL festgelegt, wenn das freigegebene Geheimnis nicht zielspezifisch sein soll.
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 |
|---|---|
|
Das freigegebene Geheimnis wurde erfolgreich festgelegt. |
|
VDS konnte nicht initialisiert werden. Wenn eine Anwendung diese Methode aufruft, bevor die Initialisierung des Diensts abgeschlossen ist, wird die Methode blockiert, bis die Initialisierung abgeschlossen ist. Wenn die Initialisierung fehlschlägt, wird dieser Fehler zurückgegeben. |
|
Der Initiatordienst unterstützt das Festlegen von zielspezifischen freigegebenen Geheimnissen nicht. |
Bemerkungen
Ein Initiator unterstützt möglicherweise das Festlegen eines anderen freigegebenen CHAP-Geheimnisses für jedes Ziel.
Es gibt keine Möglichkeit, programmgesteuert zu bestimmen, ob ein Initiator zielspezifische Geheimnisse unterstützt. Wenn der Aufruf von SetInitiatorSharedSecret VDS_E_TARGET_SPECIFIC_NOT_SUPPORTED zurückgibt, rufen Sie die Methode erneut auf, und legen Sie den targetId-Parameter auf GUID_NULL fest.
Der Microsoft iSCSI-Software-Initiator unterstützt das Festlegen von zielspezifischen Geheimnissen nicht.
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