Método IWbemClassObject::GetNames (wbemcli.h)
O método IWbemClassObject::GetNames recupera os nomes das propriedades no objeto . Além disso, dependendo dos critérios de seleção fornecidos pelo usuário, ele pode recuperar todas ou um subconjunto das propriedades. Essas propriedades podem ser acessadas usando IWbemClassObject::Get para cada nome. Esse método também pode retornar propriedades do sistema.
Sintaxe
HRESULT GetNames(
[in] LPCWSTR wszQualifierName,
[in] long lFlags,
[in] VARIANT *pQualifierVal,
[out] SAFEARRAY **pNames
);
Parâmetros
[in] wszQualifierName
Um parâmetro que pode ser NULL. Se não for NULL, ele deverá apontar para um LPCWSTR válido especificando um nome de qualificador que opera como parte de um filtro. Isso é tratado como somente leitura. Para obter mais informações, consulte Comentários.
[in] lFlags
Para obter mais informações, consulte Comentários.
[in] pQualifierVal
Um parâmetro que pode ser NULL. Se não for NULL, ele deverá apontar para uma estrutura VARIANT válida inicializada para um valor de filtro. Essa VARIANT é tratada como somente leitura pelo método . Portanto, o chamador deve chamar VariantClear nele, se necessário. Para obter mais informações, consulte Comentários.
[out] pNames
Um parâmetro que não pode ser NULL, mas na entrada esse parâmetro deve apontar para NULL. Uma nova estrutura SAFEARRAY é sempre alocada e o ponteiro é definido para apontar para ela. A matriz retornada pode ter 0 elementos, mas é sempre alocada quando WBEM_S_NO_ERROR retorna. Em caso de erro, uma nova estrutura SAFEARRAY não é retornada.
Retornar valor
Esse método retorna um HRESULT que indica o status da chamada de método. A lista a seguir lista o valor contido em um HRESULT. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.
Comentários
Os nomes retornados são controlados por uma combinação de sinalizadores e parâmetros. Por exemplo, todos os nomes de todas as propriedades podem ser especificados ou apenas as propriedades de chave podem ser especificadas e assim por diante. O filtro primário é especificado no parâmetro lFlags ; os outros parâmetros variam dependendo dele.
Os valores de sinalizador são campos de bits e podem ser combinados. Um sinalizador de cada um dos grupos a seguir pode ser combinado com um sinalizador de cada um dos outros grupos. Os valores de sinalizador dentro de um grupo são mutuamente exclusivos.
| Sinalizadores do grupo 1 | Descrição |
|---|---|
| WBEM_FLAG_ALWAYS | Retornar todos os nomes de propriedade. Os parâmetros strQualifierName e pQualifierVal não são usados. |
| WBEM_FLAG_ONLY_IF_TRUE | Retornar somente propriedades que tenham um qualificador do nome especificado pelo parâmetro strQualifierName. Se esse sinalizador for usado, você deverá especificar strQualifierName. |
| WBEM_FLAG_ONLY_IF_FALSE | Retornar somente propriedades que não têm um qualificador do nome especificado pelo parâmetro strQualifierName. Se esse sinalizador for usado, você deverá especificar strQualifierName. |
| WBEM_FLAG_ONLY_IF_IDENTICAL | Retornar somente propriedades que tenham um qualificador do nome especificado pelo parâmetro QualifierName e também tenham um valor idêntico ao valor especificado pela estrutura VARIANT apontada por pQualifierVal. Se esse sinalizador for usado, você deverá especificar QualifierName e pQualifierVal. |
| Sinalizadores do grupo 2 | Descrição |
|---|---|
| WBEM_FLAG_KEYS_ONLY | Retornar somente os nomes da propriedade ou das propriedades que definem as chaves. |
| WBEM_FLAG_REFS_ONLY | Retornam apenas nomes de propriedade que são referências de objeto. |
| Sinalizadores do grupo 3 | Descrição |
|---|---|
| WBEM_FLAG_LOCAL_ONLY | Retornar somente nomes de propriedade que pertencem à classe mais derivada. Exclua as propriedades da classe pai ou das classes pai. |
| WBEM_FLAG_PROPAGATED_ONLY | Retornar somente nomes de propriedade que pertencem à classe pai ou às classes pai. |
| WBEM_FLAG_SYSTEM_ONLY | Retornar somente propriedades do sistema. |
| WBEM_FLAG_NONSYSTEM_ONLY | Retornar somente nomes de propriedade que não são propriedades do sistema. |
Não é um erro que uma lista vazia seja retornada nos casos em que nenhuma propriedade corresponda aos filtros especificados.
Para obter mais informações sobre como usar estruturas SAFEARRAY de valores BSTR , consulte Recuperando parte de uma instância WMI.
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | wbemcli.h (include Wbemidl.h) |
| Biblioteca | WbemUuid.lib |
| DLL | CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll |