Compartilhar via


Método IWbemPath::GetNamespaceAt (wmiutils.h)

O método IWbemPath::GetNamespaceAt recupera um namespace com base em seu índice. O namespace mais à esquerda no caminho tem um índice de 0 com cada namespace movendo para a direita com um valor de índice progressivamente maior.

Sintaxe

HRESULT GetNamespaceAt(
  [in]      ULONG  uIndex,
  [in, out] ULONG  *puNameBufLength,
  [in, out] LPWSTR pName
);

Parâmetros

[in] uIndex

Índice do namespace a ser lido. O namespace mais à esquerda no caminho é index 0 com cada namespace à direita com um valor de índice progressivamente maior. O valor máximo permitido é um menor que o número atual de namespaces.

[in, out] puNameBufLength

O chamador define isso como o número de caracteres que o buffer pode conter. Após o sucesso, isso é definido como o número de caracteres copiados para o buffer, incluindo o terminador NULL .

[in, out] pName

Nome do namespace.

Retornar valor

Esse método retorna um HRESULT que indica o status da chamada de método.

Comentários

Esse método pode ser usado para determinar o tamanho de um buffer necessário para pName. Isso é feito passando um ponteiro NULL para o buffer, definindo puNameBufLength como 0 e, em seguida, fazendo a chamada. Após o retorno, puNameBufLength indica o tamanho de um buffer necessário para pName e seu caractere NULL de terminação.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho wmiutils.h
Biblioteca Wbemuuid.lib
DLL Wmiutils.dll

Confira também

IWbemPath