IWbemCallResult::GetResultString-Methode (wbemcli.h)

Artikel
08/27/2023

Die IWbemCallResult::GetResultString-Methode gibt den zugewiesenen Objektpfad eines von IWbemServices::P utInstance neu erstellten instance zurück.

Hinweis Das Aufrufergebnisobjekt wird hauptsächlich verwendet, wenn der PutInstance-Aufruf von einem Anbieter ausgeführt wird und der Client den Dem Anbieter zugewiesenen Objektpfad (die Werte der Schlüsseleigenschaften) kennen muss. Wenn die Klassenschlüsseleigenschaft beispielsweise eine GUID (Globally Unique Identifier) ist, die vom Anbieter während des PutInstance-Vorgangs zugewiesen wird, hat der Client keine Möglichkeit, diese GUID zu kennen, es sei denn, der Anbieter konnte sie auf diese Weise zurückgeben.

Syntax

HRESULT GetResultString(
  [in]  long lTimeout,
  [out] BSTR *pstrResultString
);

Parameter

[in] lTimeout

Gibt die maximale Zeit in Millisekunden an, die dieser Aufruf vor der Rückgabe blockiert. Wenn Sie die konstante WBEM_INFINITE (0xFFFFFFFF) verwenden, wird der Aufruf blockiert, bis der Objektpfad verfügbar ist. Wenn Sie 0 verwenden, gibt der Aufruf sofort entweder den Objektpfad oder einen status Code zurück.

[out] pstrResultString

Darf nicht NULL sein. Dieser Parameter empfängt einen Zeiger auf den Objektpfad, der wiederum zum neu erstellten Objekt führt. Die zurückgegebene Zeichenfolge muss mithilfe des Systemaufrufs SysFreeString aufgehoben werden. Bei Einem Fehler wird keine neue Zeichenfolge zurückgegeben.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. In der folgenden Liste ist der in einem HRESULT enthaltene Wert aufgeführt.

Bei Einem Fehler können Sie die COM-Funktion GetErrorInfo aufrufen, um weitere Fehlerinformationen zu erhalten.

COM-spezifische Fehlercodes können auch zurückgegeben werden, wenn Netzwerkprobleme dazu führen, dass Die Remoteverbindung mit der Windows-Verwaltung verloren geht.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wbemcli.h (include Wbemidl.h)

Weitere Informationen

IWbemCallResult

IWbemServices::PutInstance

Freigeben über