IWSManSession::Create-Methode (wsmandisp.h)

Artikel
03/04/2024

Erstellt eine neue instance einer Ressource und gibt den Endpunktverweis (Endpoint Reference, EPR) des neuen Objekts zurück.

Syntax

HRESULT Create(
  [in]  VARIANT resourceUri,
  [in]  BSTR    resource,
  [in]  long    flags,
  [out] BSTR    *newUri
);

Parameter

[in] resourceUri

Der Bezeichner der zu erstellenden Ressource.

Dieser Parameter kann eine der folgenden Elemente enthalten:

URI mit mindestens einem Selektor. Beachten Sie, dass das WMI-Plug-In das Erstellen einer anderen Ressource als einen WS-Management-Protokolllistener nicht unterstützt.
ResourceLocator-Objekt , das Selektoren, Fragmente oder Optionen enthalten kann.
WS-Adressierungsendpunktreferenz , wie im WS-Management-Protokollstandard beschrieben. Weitere Informationen zur öffentlichen Spezifikation für das WS-Management-Protokoll finden Sie auf der Seite Index der Verwaltungsspezifikationen.

[in] resource

Eine XML-Zeichenfolge, die Ressourceninhalte enthält.

[in] flags

Reserviert. Muss auf 0 festgelegt werden.

[out] newUri

Der EPR der neuen Ressource.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

IWSManSession::Create wird nur zum Erstellen neuer Instanzen einer Ressource verwendet. Verwenden Sie die IWSManSession::P ut-Methode , um vorhandene Instanzen einer Ressource zu aktualisieren. Nachdem Sie den neuen Ressourcen-URI abgerufen haben, können Sie IWSManSession::Get aufrufen, um das neue Objekt abzurufen. Das neue Objekt enthält alle Eigenschaften, die der Ressourcenanbieter beim Erstellen des neuen Objekts zuweist. Wenn Sie beispielsweise einen neuen WS-ManagementProtokolllistener erstellen und das Listenerobjekt mithilfe von Session.Get abrufen, erhalten Sie auch die Eigenschaften Port, Enabled und ListeningOn .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wsmandisp.h
Bibliothek	WSManDisp.tlb
DLL	WSMAuto.dll

Weitere Informationen

IWSManSession

Session.Create