Funzione Create

La Create funzione crea un file MIF di stato usato da Configuration Manager per correlare lo stato di installazione di un annuncio pubblicitario.

Sintassi

StatusMIF.Create(
     ByVal bstrFileName As String _
     ByVal bstrCompany As String _
     ByVal bstrProduct As String _
     ByVal bstrVersion As String _
     ByVal bstrLocale As String _
     ByVal bstrSerialNo As String _
     ByVal bstrMessage As String _
     ByVal bStatus As Long _
);

Parametri

bstrFileName Nome univoco per il file MIF. L'estensione di file deve essere .mif. La funzione scrive il file nella directory %TEMP%.

bstrCompany Produttore o editore del prodotto, ad esempio Microsoft. Questo parametro è limitato a 64 caratteri.

bstrProduct Nome del prodotto o del programma, ad esempio Office 2000. Questo parametro è limitato a 64 caratteri.

bstrVersion Versione del prodotto, ad esempio 8.0a. Questo parametro è limitato a 64 caratteri.

bstrLocale Codice paese/area geografica o lingua, ad esempio ENU. Questo parametro è facoltativo ed è limitato a 16 caratteri.

bstrSerialNo Numero di serie del prodotto. Questo parametro è facoltativo ed è limitato a 64 caratteri.

bstrMessage Messaggio descrittivo sullo stato dell'installazione, aggiunto al messaggio di stato del programma. Questo parametro è limitato a 128 caratteri.

bStatus true se lo stato dell'installazione è riuscito.

Valori restituiti

Nessuna.

Osservazioni

L'applicazione di installazione (setup) deve creare un solo file MIF di stato di installazione per il pacchetto. Il nome file deve essere univoco in modo che più installazioni in un'unica sessione possano segnalare lo stato senza conflitti.

Le installazioni eseguite in versioni localizzate di Configuration Manager devono specificare i valori nel formato appropriato: formato ANSI per le lingue europee; Formato DBCS per le lingue dell'Asia orientale.

L'applicazione deve chiamare InstallStatusMIF prima dell'uscita dell'installazione. Il file MIF non viene segnalato a Configuration Manager se l'installazione crea un altro processo che chiama InstallStatusMIF.

Si noti che i parametri bstrFilename, bstrCompany, bstrProduct, e bstrVersion sono direttamente correlati rispettivamente alle proprietà MIFFileNamedella classe WMI del server SMS_Package , MIFPublisherMIFName, e MIFVersion. Questi parametri e proprietà devono contenere gli stessi valori.

L'esempio nella sezione seguente mostra come chiamare il Create metodo.

Esempio

[VisualBasic]
   Dim MIFStatus As New InstallStatusMIF

   MIFStatus.Create "MyStatusFile", _
                    "MyCompany", _
                    "MyProduct", _
                    "1.00.000", _
                    "ENU", _
                    " ", _
                    "Installation Successful", _
                    True

Requisiti

Windows NT/2000: richiede Windows NT 4.0 o versione successiva.

Windows 95/98: richiede Windows 95 o versione successiva.

Versione: richiede SMS 2.0.

Libreria: inclusa come risorsa in IsMIFCom.dll (Visual Basic).

Vedere anche

Stato Funzioni MIFSMS_Package classe WMI del server