Metodo IMofCompiler::CompileFile (wbemcli.h)
Il metodo IMofCompiler::CompileFile compila un file MOF (inclusi i MOFs binari) e archivia le informazioni nel repository WMI. Questo metodo esegue la stessa operazione del comando Mofcomp .
Sintassi
HRESULT CompileFile(
[in] LPWSTR FileName,
[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] FileName
Nome del file da compilare.
[in] ServerAndNamespace
Percorso dello spazio dei nomi predefinito in cui vengono scritte le classi o le istanze.
È possibile specificare uno spazio dei nomi in un computer remoto ("\computer\root", ad esempio). Questo valore può essere sottoposto a override dal comando #pragma e non deve essere usato se il ripristino automatico è desiderato. Se NULL, lo spazio dei nomi radice\predefinito nel computer locale è il valore predefinito.
[in] User
Valore che specifica le credenziali usate per la compilazione nei computer remoti. Se il valore è NULL, il contesto utente è indipendentemente dal processo di chiamata. Questa operazione viene sempre ignorata durante la connessione al computer locale. Per altre informazioni, vedere la sezione Osservazioni.
[in] Authority
Valore che specifica le credenziali per la compilazione nei computer remoti. Se il valore è NULL, il contesto dell'autorità è qualsiasi cosa stia usando il processo chiamante. Questa operazione viene sempre ignorata durante la connessione al computer locale. Per altre informazioni, vedere la sezione Osservazioni.
[in] Password
Valore che specifica le credenziali per la compilazione nei computer remoti. Se il valore è NULL, viene usata la password del contesto corrente. Questa operazione viene sempre ignorata durante la connessione al computer locale.
[in] lOptionFlags
Un parametro che, quando viene usato il metodo CompileFile , abilita la combinazione di 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.
Tenere presente che 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 compilati durante il ripristino automatico del database.
Questo flag non è compatibile con WBEM_FLAG_AUTORECOVER.
[in] lClassFlags
Flag che controllano la creazione di classi.
I parametri possono essere 0 o una combinazione dei valori seguenti.
WBEM_FLAG_UPDATE_ONLY
Impedisce la creazione di una classe.
È possibile combinare questo flag con WBEM_FLAG_UPDATE_SAFE_MODE o WBEM_FLAG_UPDATE_FORCE_MODE.
WBEM_FLAG_CREATE_ONLY
Consente solo la creazione di classi.
Non è possibile combinare questo flag con gli altri flag.
WBEM_FLAG_UPDATE_SAFE_MODE
Aggiornamenti la classe a meno che non esistano conflitti.
È possibile combinare questo flag con WBEM_FLAG_UPDATE_ONLY.
WBEM_FLAG_UPDATE_FORCE_MODE
Aggiornamenti e risolve i conflitti ovunque possibile. L'uso della modalità forza per aggiornare una classe statica comporta l'eliminazione di tutte le istanze di tale classe. Forzare l'aggiornamento in una classe provider non elimina le istanze della classe.
È possibile combinare questo flag con llnstanceFlags.
[in] lInstanceFlags
Flag che controllano la creazione di istanze.
I valori dei parametri possono essere 0 o uno dei flag seguenti.
WBEM_FLAG_UPDATE_ONLY
Consenti solo gli aggiornamenti.
WBEM_FLAG_CREATE_ONLY
Consenti solo nuove istanze.
[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 riempita con informazioni sull'errore.
Valore restituito
Questo metodo può restituire uno di questi valori.
2
Avviso che #pragma'istruzione di ripristino automatico non è presente. Questa istruzione deve essere una prima riga del file MOF.
Commenti
Se il parametro User è sotto forma di <dominio\user>, il parametro Authority deve essere NULL.
Requisiti
| 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 |