Metodo QueryOSDBinaryInjectionStatus nella classe SMS_BootImagePackage

Il QueryOSDBinaryInjectionStatus metodo della classe Strumentazione gestione Windows (WMI), in Configuration Manager, interroga lo stato corrente dell'inserimento di file binari di distribuzione del sistema operativo in un'immagine di avvio.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e definisce il metodo.

Sintassi

SInt32 QueryOSDBinaryInjectionStatus(
     String ContextID,
     UInt32 Status,
     UInt32 Progress,
     UInt32 MaxProgress,
     String ProgressText,
     SInt32 ErrorCode,
     String ExtendedErrorInfo
);

Parametri

ContextID Tipo: String

Qualificazioni: [in]

ID del contesto (indice) facoltativamente associato allo stato al momento dell'importazione di un'immagine di avvio. Questo ID è indicato dalla ContextID proprietà della classe WMI del server SMS_BootImagePackage.

Status Tipo: UInt32

Qualificazioni: [fuori]

Stato corrente dell'inserimento binario. I valori possibili sono:

Progress Tipo: UInt32

Qualificazioni: [fuori]

Stato di avanzamento che indica il numero del passaggio corrente nell'operazione di inserimento binario.

MaxProgress Tipo: UInt32

Qualificazioni: [fuori]

Numero totale di passaggi dell'operazione di inserimento binario.

ProgressText Tipo: String

Qualificazioni: [fuori]

Stringa leggibile dall'utente che identifica lo stato corrente dell'operazione di inserimento binario.

ErrorCode Tipo: SInt32

Qualificazioni: [fuori]

Codice di errore a 32 bit in caso di errore nell'operazione di inserimento del file binario. Un esempio di codice di errore è FILE_NOT_FOUND (2). Il file di log contiene i dettagli del codice di errore.

ExtendedErrorInfo Tipo: String

Qualificazioni: [fuori]

Informazioni aggiuntive sull'errore se il ErrorCode parametro è impostato su un codice di errore. Attualmente questo parametro viene usato per segnalare le informazioni sui file del driver se l'operazione di inserimento binario non riesce a inserire i file binari per un determinato driver.

Valori restituiti

Tipo SInt32 di dati con valore 0 per indicare l'esito positivo o diverso da zero per indicare l'esito negativo.

Per informazioni sulla gestione degli errori restituiti, vedere Informazioni sugli errori di Configuration Manager.

Osservazioni

Per usare il metodo, l'applicazione QueryOSDBinaryInjectionStatus deve:

1. Stabilire una connessione al provider SMS. Per ulteriori informazioni, consulta Nozioni fondamentali sul provider SMS.

2. Accedere all'oggetto della classe WMI del server SMS_BootImagePackage .

3. Chiamare il metodo ExportDefaultBootImage nella classe SMS_BootImagePackage.

4. Quindi, chiamare QueryOSDBinaryInjectionStatus se necessario per scoprire lo stato dell'operazione di inserimento binario.

5. Usare i valori dei parametri and MaxProgress per determinare lo stato percentuale di Progress completamento dell'operazione di inserimento binario.

Requisiti

Requisiti di runtime

Per altre informazioni, vedere Configuration Manager Requisiti di runtime del server.

Requisiti di sviluppo

Per altre informazioni, vedere Requisiti di sviluppo del server di Configuration Manager.

Vedere anche

Metodo ExportDefaultBootImage della classe WMI del server SMS_BootImagePackagenella classe SMS_BootImagePackage