Metodo IPart::GetGlobalId (devicetopology.h)

  • Articolo

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.

Codice restituito Descrizione
E_POINTER
 Pointer ppwstrGlobalId è NULL.
E_OUTOFMEMORY
 Memoria insufficiente.

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

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione devicetopology.h

Vedi anche

Interfaccia IPart