Método QueryOSDBinaryInjectionStatus na classe SMS_BootImagePackage

O QueryOSDBinaryInjectionStatus método de classe WMI (Instrumentação de Gerenciamento do Windows), no 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 a partir do código MOF (Managed Object Format) 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

Eliminatórias: [em]

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 SMS_BootImagePackage Server.

Status Tipo de dados: UInt32

Eliminatórias: [fora]

O status atual da injeção binária. Os valores possíveis são:

Valor Status
0 Completo
1 Em andamento
2 Erro
3 Sem status

Progress Tipo de dados: UInt32

Eliminatórias: [fora]

O status de progresso indicando o número da etapa atual na operação de injeção binária.

MaxProgress Tipo de dados: UInt32

Eliminatórias: [fora]

O número total de etapas na operação de injeção binária.

ProgressText Tipo de dados: String

Eliminatórias: [fora]

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

Eliminatórias: [fora]

Um código de erro de 32 bits no caso de um 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

Eliminatórias: [fora]

Informações adicionais sobre o 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 de driver se a operação de injeção binária não conseguir injetar os binários para um driver específico.

Return Values

Um SInt32 tipo de dados que é 0 para indicar sucesso ou diferente de zero para indicar falha.

Para obter informações sobre como lidar com erros retornados, consulte Sobre erros do Configuration Manager.

Comentários

Para usar o QueryOSDBinaryInjectionStatus método, seu aplicativo deve:

  1. Estabeleça uma conexão com o provedor de SMS. Para obter mais informações, consulte Noções básicas do provedor de SMS.

  2. Acesse o objeto de classe WMI do SMS_BootImagePackage Server .

  3. Chame o método ExportDefaultBootImage na classe SMS_BootImagePackage.

  4. Em seguida, ligue QueryOSDBinaryInjectionStatus conforme necessário para descobrir o status da operação de injeção binária.

  5. Use os Progress valores dos parâmetros and MaxProgress para determinar o status de porcentagem concluída da operação de injeção binária.

Requisitos

Requisitos de tempo de execução

Para obter mais informações, consulte Requisitos de tempo de execução do servidor do Configuration Manager.

Requisitos de desenvolvimento

Para obter mais informações, consulte Requisitos de Desenvolvimento de Servidor do Configuration Manager.

Confira também

Método ExportDefaultBootImage da classe WMI do SMS_BootImagePackage Serverna classe SMS_BootImagePackage