Metodo IWbemContext::GetNames (wbemcli.h)
Il metodo IWbemContext::GetNames restituisce una struttura SAFEARRAY di tutti i nomi dei valori di contesto denominati. Dopo che tutti i nomi sono noti, GetValue può essere chiamato su ogni nome per recuperare il valore. Questa tecnica è un modo per accedere ai valori di contesto diversi dalla chiamata ai metodi BeginEnumeration, Next e EndEnumeration.
Sintassi
HRESULT GetNames(
[in] long lFlags,
[out] SAFEARRAY **pNames
);
Parametri
[in] lFlags
Riservato. Questo parametro deve essere 0.
[out] pNames
Questo parametro non può essere NULL, ma nella voce deve puntare a NULL. Se non viene restituito alcun errore, in uscita pstrNames riceve un puntatore a una nuova struttura SAFEARRAY di tipo VT_BSTR contenente tutti i nomi dei valori di contesto. Il chiamante deve chiamare SafeArrayDestroy sul puntatore restituito quando la matrice non è più necessaria. Se viene restituito un codice di errore, il puntatore viene lasciato non modificato.
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.
Commenti
Per altre informazioni sull'uso di strutture SAFEARRAY di valori BSTR , vedere Recupero di parte di un'istanza WMI.
Requisiti
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | wbemcli.h (include Wbemidl.h) |
| Libreria | Wbemuuid.lib |
| DLL | Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wmipjobj.dll |