Share via

Método IPart::GetGlobalId (devicetopology.h)

  • Artigo

O método GetGlobalId obtém a ID global dessa parte.

Sintaxe

HRESULT GetGlobalId(
  [out] LPWSTR *ppwstrGlobalId
);

Parâmetros

[out] ppwstrGlobalId

Ponteiro para uma variável de ponteiro na qual o método grava o endereço de uma cadeia de caracteres largos terminada em nulo que contém a ID global. O método aloca o armazenamento para a cadeia de caracteres. O chamador é responsável por liberar o armazenamento, quando ele não é mais necessário, chamando a função CoTaskMemFree . Se a chamada GetGlobalId falhar, *ppwstrGlobalId será NULL. Para obter informações sobre CoTaskMemFree, consulte a documentação do SDK do Windows.

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno Descrição
E_POINTER
 Pointer ppwstrGlobalId é NULL.
E_OUTOFMEMORY
 Sem memória.

Comentários

Uma ID global é uma cadeia de caracteres que identifica exclusivamente uma parte entre todas as partes em todas as topologias de dispositivo no sistema. Os clientes devem tratar essa cadeia de caracteres como opaca. Ou seja, os clientes não devem tentar analisar o conteúdo da cadeia de caracteres para obter informações sobre a parte. O motivo é que o formato de cadeia de caracteres é indefinido e pode mudar de uma implementação da API DeviceTopology para a próxima.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho devicetopology.h

Confira também

IPart Interface