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

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.

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

Confira também

IPart Interface