Metodo IMofCompiler::CompileBuffer (wbemcli.h)

  • Articolo

Il metodo IMofCompiler::CompileBuffer compila un buffer contenente dati MOF binari o un buffer di testo in formato ASCII. I file MOF binari contengono dati analizzati e devono essere archiviati nel database. Il metodo CompileBuffer accetta solo matrici di caratteri a più byte (buffer di stringhe) che non terminano con NULL.

Sintassi

HRESULT CompileBuffer(
  [in]      long                     BuffSize,
  [in]      BYTE                     *pBuffer,
  [in]      LPWSTR                   ServerAndNamespace,
  [in]      LPWSTR                   User,
  [in]      LPWSTR                   Authority,
  [in]      LPWSTR                   Password,
  [in]      LONG                     lOptionFlags,
  [in]      LONG                     lClassFlags,
  [in]      LONG                     lInstanceFlags,
  [in, out] WBEM_COMPILE_STATUS_INFO *pInfo
);

Parametri

[in] BuffSize

Dimensioni dei dati a cui punta il parametro pBuffer .

[in] pBuffer

Puntatore ai dati del file MOF binario o a un buffer di testo in formato ASCII.

[in] ServerAndNamespace

Nome del server e dello spazio dei nomi.

Questo parametro viene ignorato a meno che il parametro pBuffer non punti a un buffer di testo. Se il file MOF di testo viene passato senza un'istruzione #pragma , il file MOF viene compilato nello spazio dei nomi predefinito. Se pBuffer punta a un file MOF binario, il parametro ServerAndNamespace deve essere NULL.

[in] User

Nome dell'utente che richiede il servizio.

Questo parametro specifica le credenziali per la compilazione nei computer remoti. Se il valore è NULL, il contesto utente è indipendentemente dal processo corrente. Questo viene sempre ignorato durante la connessione al computer locale. Per altre informazioni, vedere la sezione Osservazioni.

[in] Authority

Specifica le credenziali per la compilazione nei computer remoti. Se il valore è NULL, il contesto dell'autorità è indipendentemente dal processo corrente. Questo parametro viene sempre ignorato durante la connessione al computer locale. Per altre informazioni, vedere la sezione Osservazioni.

[in] Password

Specifica le credenziali per la compilazione nei computer remoti. Se il valore è NULL, viene usata la password del contesto corrente. Questo parametro viene sempre ignorato durante la connessione al computer locale.

[in] lOptionFlags

È possibile combinare uno o più flag seguenti.

WBEM_FLAG_CHECK_ONLY

Esegue solo un controllo della sintassi.

WBEM_FLAG_AUTORECOVER

Se il metodo ha esito positivo, aggiunge il nome del file all'elenco di file da compilare durante il ripristino automatico del database.

Questo flag non può essere combinato con lo spazio dei nomi, la classe o i flag di istanza.

WBEM_FLAG_CONSOLE_PRINT

Invia vari messaggi utili alla console.

WBEM_FLAG_DONT_ADD_TO_LIST

Impedisce l'aggiunta del file all'elenco di file da compilare durante il ripristino automatico del database.

Questo flag non è compatibile con WBEM_FLAG_AUTORECOVER.

[in] lClassFlags

Questo parametro viene ignorato perché il file MOF binario contiene già le informazioni. Il valore del parametro deve essere 0.

[in] lInstanceFlags

Ignorato perché il file MOF binario contiene già le informazioni. Il valore del parametro deve essere 0.

[in, out] pInfo

Puntatore a un WBEM_COMPILE_STATUS_INFO che descrive un errore.

Se il valore del parametro non è NULL, si è verificato un errore e la struttura viene compilata con informazioni sull'errore.

Valore restituito

Questo metodo restituisce WBEM_S_NO_ERROR in caso di esito positivo. Se il metodo ha esito negativo, restituisce WBEM_S_FALSE.

Commenti

Se il parametro User accetta il formato <domain\user>, il parametro Authority deve essere NULL.

I dati MOF binari possono essere generati dal metodo CreateBMOF , che archivia i dati MOF binari in un file che può essere letto prima di chiamare il metodo CompileBuffer .

Requisiti

Requisito Valore
Client minimo supportato Windows Vista
Server minimo supportato Windows Server 2008
Piattaforma di destinazione Windows
Intestazione wbemcli.h (include Wbemidl.h)
Libreria Wbemuuid.lib
DLL Mofd.dll

Vedi anche

IMofCompiler

WBEM_COMPILER_OPTIONS