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

Vedi anche

IMofCompiler

WBEM_CHANGE_FLAG_TYPE

WBEM_COMPILER_OPTIONS

mofcomp