Método QueryOSDBinaryInjectionStatus na classe SMS_BootImagePackage
O QueryOSDBinaryInjectionStatus
método de classe WMI (Instrumentação de Gerenciamento do Windows), em Configuration Manager, consulta o status atual da injeção de binários de implantação do sistema operacional em uma imagem de inicialização.
A sintaxe a seguir é simplificada do código MOF (Formato de Objeto Gerenciado) e define o método.
Sintaxe
SInt32 QueryOSDBinaryInjectionStatus(
String ContextID,
UInt32 Status,
UInt32 Progress,
UInt32 MaxProgress,
String ProgressText,
SInt32 ErrorCode,
String ExtendedErrorInfo
);
Parâmetros
ContextID
Tipo de dados: String
Qualificadores: [in]
A ID do contexto (índice) opcionalmente associada ao status após a importação de uma imagem de inicialização. Essa ID é indicada pela ContextID
propriedade da classe WMI do servidor SMS_BootImagePackage.
Status
Tipo de dados: UInt32
Qualificadores: [out]
O status atual da injeção binária. Os valores possíveis são:
Valor | Status |
---|---|
0 | Concluído |
1 | Em andamento |
2 | Error |
3 | Sem status |
Progress
Tipo de dados: UInt32
Qualificadores: [out]
O status de progresso que indica o número da etapa atual na operação de injeção binária.
MaxProgress
Tipo de dados: UInt32
Qualificadores: [out]
O número total de etapas na operação de injeção binária.
ProgressText
Tipo de dados: String
Qualificadores: [out]
Uma cadeia de caracteres legível pelo usuário que identifica o progresso atual da operação de injeção binária.
ErrorCode
Tipo de dados: SInt32
Qualificadores: [out]
Um código de erro de 32 bits em caso de erro na operação de injeção binária. Um exemplo de código de erro é FILE_NOT_FOUND (2). O arquivo de log contém detalhes do código de erro.
ExtendedErrorInfo
Tipo de dados: String
Qualificadores: [out]
Informações adicionais de erro se o ErrorCode
parâmetro estiver definido como um código de erro. Atualmente, esse parâmetro é usado para relatar informações de arquivo do driver se a operação de injeção binária não injetar os binários em um driver específico.
Return Values
Um SInt32
tipo de dados que é 0 para indicar êxito ou não zero para indicar falha.
Para obter informações sobre como lidar com erros retornados, consulte Sobre erros de Configuration Manager.
Comentários
Para usar o método, seu QueryOSDBinaryInjectionStatus
aplicativo deve:
Estabeleça uma conexão com o provedor de SMS. Para obter mais informações, confira Os fundamentos do provedor de SMS.
Acesse o objeto classe WMI do servidor SMS_BootImagePackage .
Chame o Método ExportDefaultBootImage na classe SMS_BootImagePackage.
Em seguida, chame
QueryOSDBinaryInjectionStatus
conforme necessário para descobrir o status da operação de injeção binária.Use os valores dos
Progress
parâmetros eMaxProgress
para determinar o status por cento completo da operação de injeção binária.
Requisitos
Requisitos de runtime
Para obter mais informações, consulte Configuration Manager Requisitos de Runtime do Servidor.
Requisitos de desenvolvimento
Para obter mais informações, consulte Configuration Manager Requisitos de Desenvolvimento do Servidor.
Confira também
Classe WMI do servidor SMS_BootImagePackage
Método ExportDefaultBootImage na classe SMS_BootImagePackage