Metodo IPart::GetGlobalId (devicetopology.h)

Il metodo GetGlobalId ottiene l'ID globale di questa parte.

Sintassi

HRESULT GetGlobalId(
  [out] LPWSTR *ppwstrGlobalId
);

Parametri

[out] ppwstrGlobalId

Puntatore a una variabile puntatore in cui il metodo scrive l'indirizzo di una stringa di caratteri wide con terminazione Null contenente l'ID globale. Il metodo alloca lo spazio di archiviazione per la stringa. Il chiamante è responsabile della liberazione dello spazio di archiviazione, quando non è più necessario, chiamando la funzione CoTaskMemFree . Se la chiamata GetGlobalId ha esito negativo, *ppwstrGlobalId è NULL. Per informazioni su CoTaskMemFree, vedere la documentazione di Windows SDK.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.

Commenti

Un ID globale è una stringa che identifica in modo univoco una parte tra tutte le parti di tutte le topologie di dispositivo nel sistema. I client devono considerare questa stringa come opaca. Ovvero, i client non devono tentare di analizzare il contenuto della stringa per ottenere informazioni sulla parte. Il motivo è che il formato stringa non è definito e potrebbe cambiare da un'implementazione dell'API DeviceTopology alla successiva.

Requisiti

Vedi anche

Interfaccia IPart