Método IWbemContext::GetNames (wbemcli.h)

  • Artículo

El método IWbemContext::GetNames devuelve una estructura SAFEARRAY de todos los nombres de los valores de contexto con nombre. Una vez conocidos todos los nombres, se puede llamar a GetValue en cada nombre para recuperar el valor. Esta técnica es una forma de acceder a los valores de contexto que son diferentes de llamar a los métodos BeginEnumeration, Next y EndEnumeration .

Sintaxis

HRESULT GetNames(
  [in]  long      lFlags,
  [out] SAFEARRAY **pNames
);

Parámetros

[in] lFlags

Reservado. El valor de este parámetro deberá ser 0.

[out] pNames

Este parámetro no puede ser NULL, pero en la entrada debe apuntar a NULL. Si no se devuelve ningún error, en exit pstrNames recibe un puntero a una nueva estructura SAFEARRAY de tipo VT_BSTR que contiene todos los nombres de valor de contexto. El llamador debe llamar a SafeArrayDestroy en el puntero devuelto cuando la matriz ya no es necesaria. Si se devuelve un código de error, el puntero se deja sin modificar.

Nota Si no hay valores con nombre en el objeto, la llamada se realiza correctamente y devuelve una matriz de longitud 0.
 

Valor devuelto

Este método devuelve un HRESULT que indica el estado de la llamada al método. En la lista siguiente se muestra el valor contenido en un HRESULT.

Comentarios

Para obtener más información sobre el uso de estructuras SAFEARRAY de valores BSTR , vea Recuperar parte de una instancia de WMI.

Requisitos

   
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado wbemcli.h (include Wbemidl.h)
Library Wbemuuid.lib
Archivo DLL Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wmipjobj.dll

Consulte también

IWbemContext

IWbemContext::BeginEnumeration

IWbemContext::GetValue