Condividi tramite


Metodo IMDSPStorageGlobals::GetSerialNumber (mswmdm.h)

Il metodo GetSerialNumber recupera un numero di serie che identifica in modo univoco il supporto di archiviazione. Questo metodo deve essere implementato per il trasferimento di contenuto protetto, ma in caso contrario è facoltativo. Per altre informazioni, vedere Interfacce obbligatorie e facoltative.

.

Sintassi

HRESULT GetSerialNumber(
  [out]     PWMDMID  pSerialNum,
  [in, out] BYTE [8] abMac
);

Parametri

[out] pSerialNum

Puntatore a una struttura WMDMID contenente le informazioni sul numero di serie. Questo parametro è incluso nel codice di autenticazione del messaggio di output.

[in, out] abMac

Matrice di otto byte contenente il codice di autenticazione dei messaggi per i dati dei parametri di questo metodo. (WMDM_MAC_LENGTH è definito come 8.)

Valore restituito

Il metodo restituisce un HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:

  • Codici di errore COM standard
  • Codici di errore di Windows convertiti in valori HRESULT
  • Codici di errore di Windows Media Gestione dispositivi
Per un elenco completo dei codici di errore possibili, vedere Codici di errore.

Commenti

Non tutti i supporti di archiviazione supportano i numeri di serie. Il codice restituito deve sempre essere controllato per determinare se il supporto di archiviazione fornisce questo supporto. Se il supporto di archiviazione non supporta la restituzione di un numero di serie univoco, il contenuto protetto non può essere trasferito al supporto. Se l'archiviazione rappresentata è un supporto rimovibile, il numero di serie restituito deve essere il numero di serie di archiviazione, che deve essere distinto dal numero di serie del dispositivo.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione mswmdm.h
Libreria Mssachlp.lib

Vedi anche

Interfaccia IMDSPStorageGlobals

WMDMID