Função GetNamesGetNames function

Recupera um subconjunto ou todos os nomes das propriedades de um objeto.Retrieves either a subset or all of the names of the properties of an object.

Observação

Esta API é somente para uso interno.This API is for internal use only. Ela não é destinada ao uso do código do desenvolvedor.It's not intended for use from developer code.

SintaxeSyntax

HRESULT GetNames (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszQualifierName,
   [in] LONG                lFlags,
   [in] VARIANT*            pQualifierValue,
   [out] SAFEARRAY (BSTR)** pstrNames
);

ParâmetrosParameters

vFunc
no Este parâmetro não é usado.[in] This parameter is unused.

ptr
no Um ponteiro para uma instância de IWbemClassObject .[in] A pointer to an IWbemClassObject instance.

wszQualifierName
no Um ponteiro para um válido LPCWSTR que especifica um nome de qualificador que funciona como parte de um filtro.[in] A pointer to a valid LPCWSTR that specifies a qualifier name that operates as part of a filter. Para obter mais informações, consulte a seção comentários .For more information, see the Remarks section. Esse parâmetro pode ser null.This parameter can be null.

lFlags
no Uma combinação de campos de bits.[in] A combination of bit fields. Para obter mais informações, consulte a seção comentários .For more information, see the Remarks section.

pQualifierValue no Um ponteiro para uma VARIANT estrutura válida inicializada para um valor de filtro.pQualifierValue [in] A pointer to a valid VARIANT structure initialized to a filter value. Esse parâmetro pode ser null.This parameter can be null.

pstrNames
fora Uma SAFEARRAY estrutura que contém nomes de propriedade.[out] A SAFEARRAY structure that contains property names. Na entrada, esse parâmetro sempre deve ser um ponteiro para null .On entry, this parameter must always be a pointer to null. Consulte a seção comentários para obter mais informações.See the Remarks section for more information.

Valor retornadoReturn value

Os valores a seguir retornados por essa função são definidos no arquivo de cabeçalho WbemCli. h ou você pode defini-los como constantes em seu código:The following values returned by this function are defined in the WbemCli.h header file, or you can define them as constants in your code:

ConstanteConstant ValorValue DESCRIÇÃODescription
WBEM_E_FAILED 0x800410010x80041001 Houve uma falha geral.There has been a general failure.
WBEM_E_INVALID_PARAMETER 0x800410080x80041008 Um ou mais parâmetros não são válidos ou uma combinação incorreta de sinalizadores e parâmetros foi especificada.One or more parameters are not valid, or an incorrect combination of flags and parameters was specified.
WBEM_E_OUT_OF_MEMORY 0x800410060x80041006 Não há memória disponível suficiente para concluir a operação.Not enough memory is available to complete the operation.
WBEM_S_NO_ERROR 00 A chamada de função foi bem-sucedida.The function call was successful.

ComentáriosRemarks

Essa função encapsula uma chamada para o método IWbemClassObject:: GetNames .This function wraps a call to the IWbemClassObject::GetNames method.

O nome retornado é controlado por uma combinação de sinalizadores e parâmetros.The named returned are controlled by a combination of flags and parameters. Por exemplo, a função pode retornar os nomes de todas as propriedades ou apenas os nomes das propriedades de chave.For example, the function can return the names of all properties or only the names of the key properties. O filtro primário é especificado no lFlags parâmetro e os outros parâmetros variam dependendo dele.The primary filter is specified in the lFlags parameter, and the other parameters vary depending on it.

Os valores de sinalizador no lFlags são campos de bitsThe flag values in lFlags are bit fields

Os sinalizadores que podem ser passados como o lEnumFlags argumento são campos de bits definidos no arquivo de cabeçalho WbemCli. h ou você pode defini-los como constantes em seu código.The flags that can be passed as the lEnumFlags argument are bit fields that are defined in the WbemCli.h header file, or you can define them as constants in your code. Você pode combinar um sinalizador de cada grupo com qualquer sinalizador de qualquer outro grupo.You can combine one flag from each group with any flag from any other group. No entanto, os sinalizadores do mesmo grupo são mutuamente exclusivos.However, flags from the same group are mutually exclusive.

Sinalizadores do grupo 1Group 1 flags ValorValue DESCRIÇÃODescription
WBEM_FLAG_ALWAYS 00 Retornar todos os nomes de propriedade.Return all property names. strQualifierName e pQualifierVal não são usados.strQualifierName and pQualifierVal are unused.
WBEM_FLAG_ONLY_IF_TRUE 11 Retornar apenas as propriedades que têm um qualificador do nome especificado pelo strQualifierName parâmetro.Return only properties that have a qualifier of the name specified by the strQualifierName parameter. Se esse sinalizador for usado, você deverá especificar strQualifierName .If this flag is used, you must specify strQualifierName.
WBEM_FLAG_ONLY_IF_FALSE 22 Retornar apenas propriedades que não têm um qualificador do nome especificado pelo strQualifierName parâmetro.Return only properties that do not have a qualifier of the name specified by the strQualifierName parameter. Se esse sinalizador for usado, você deverá especificar strQualifierName .If this flag is used, you must specify strQualifierName.
WBEM_FLAG_ONLY_IF_IDENTICAL 33 Retornam apenas propriedades que têm um qualificador do nome especificado pelo wszQualifierName parâmetro e também têm um valor idêntico ao especificado pela pQualifierVal estrutura.Return only properties that have a qualifier of the name specified by the wszQualifierName parameter and also have a value identical to that specified by the pQualifierVal structure. Se esse sinalizador for usado, você deverá especificar um wszQualifierName e um pQualifierValue .If this flag is used, you must specify both a wszQualifierName and a pQualifierValue.
Sinalizadores do grupo 2Group 2 flags ValorValue DESCRIÇÃODescription
WBEM_FLAG_KEYS_ONLY 0x40x4 Retornar somente os nomes das propriedades que definem as chaves.Return only the names of properties that define the keys.
WBEM_FLAG_REFS_ONLY 0x80x8 Retornar apenas nomes de propriedade que são referências de objeto.Return only property names that are object references.
Sinalizadores do grupo 3Group 3 flags ValorValue DESCRIÇÃODescription
WBEM_FLAG_LOCAL_ONLY 0x100x10 Retornar apenas os nomes de propriedade que pertencem à classe mais derivada.Return only property names that belong to the most derived class. Exclua as propriedades das classes pai.Exclude properties from the parent classes.
WBEM_FLAG_PROPAGATED_ONLY 0x200x20 Retornar apenas os nomes de propriedade que pertencem às classes pai.Return only property names that belong to the parent classes.
WBEM_FLAG_SYSTEM_ONLY 0x300x30 Retornar apenas os nomes das propriedades do sistema.Return only the names of system properties.
WBEM_FLAG_NONSYSTEM_ONLY 0x400x40 Retornar apenas os nomes das propriedades que não são do sistema.Return only the names of non-system properties.

A função sempre aloca um novo SAFEARRAY se ele retornar WBEM_S_NO_ERROR e pstrNames sempre será definido para apontar para ele.The function always allocates a new SAFEARRAY if it returns WBEM_S_NO_ERROR, and pstrNames is always set to point to it. A matriz retornada pode ter 0 elementos se nenhuma propriedade corresponder aos filtros especificados.The returned array can have 0 elements if no properties match the specified filters. Se a função retornar um valor diferente de WBM_S_NO_ERROR , uma nova SAFEARRAY estrutura não será retornada.If the function returns an value other than WBM_S_NO_ERROR, a new SAFEARRAY structure is not returned.

RequisitosRequirements

Plataformas: confira Requisitos do sistema.Platforms: See System Requirements.

Cabeçalho: WMINet_Utils. idlHeader: WMINet_Utils.idl

.NET Framework versões:Disponível desde o 4.7.2Available since 4.7.2.NET Framework Versions: Disponível desde o 4.7.2Available since 4.7.2

Confira tambémSee also