Metodo IMofCompiler::CompileBuffer (wbemcli.h)
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 |