Metodo IWbemCallResult::GetResultString (wbemcli.h)

Articolo
03/13/2024

Il metodo IWbemCallResult::GetResultString restituisce il percorso dell'oggetto assegnato di un'istanza appena creata da IWbemServices::P utInstance.

Nota L'oggetto risultato della chiamata viene usato principalmente quando viene eseguita la chiamata PutInstance da un provider e il client deve conoscere il percorso dell'oggetto (i valori delle proprietà chiave) assegnati al provider. Ad esempio, se la proprietà della chiave di classe è un identificatore univoco globale (GUID), assegnato dal provider durante l'operazione PutInstance , il client non avrebbe modo di conoscere questo GUID a meno che il provider non fosse in grado di restituirlo in questo modo.

Sintassi

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

Parametri

[in] lTimeout

Specifica il tempo massimo in millisecondi che questa chiamata blocca prima di restituire. Se si usa la costante WBEM_INFINITE (0xFFFFFFFF ), le chiamate non vengono bloccate finché non è disponibile il percorso dell'oggetto. Se si usa 0, la chiamata restituisce immediatamente il percorso dell'oggetto o un codice di stato.

[out] pstrResultString

Impossibile essere NULL. Questo parametro riceve un puntatore al percorso dell'oggetto, che, a sua volta, porta all'oggetto appena creato. La stringa restituita deve essere deallocata usando la chiamata di sistema SysFreeString. In caso di errore, non viene restituita una nuova stringa.

Valore restituito

Questo metodo restituisce un valore HRESULT che indica lo stato della chiamata al metodo. L'elenco seguente elenca il valore contenuto in un HRESULT.

In caso di errore, è possibile chiamare la funzione COM GetErrorInfo per ottenere altre informazioni sull'errore.

I codici di errore specifici di COM possono essere restituiti anche se i problemi di rete causano la perdita della connessione remota a Gestione Windows.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	wbemcli.h (include Wbemidl.h)

Vedi anche

IWbemCallResult

IWbemServices::P utInstance

Condividi tramite