DismInitialize-Funktion
[Einige Informationen beziehen sich auf die Vorabversion, die vor der kommerziellen Freigabe möglicherweise wesentlichen Änderungen unterliegt. Microsoft übernimmt für die hier bereitgestellten Informationen keine Gewährleistung, weder ausdrücklicher noch impliziter Art.]
Initialisiert die DISM-API. DismInitialize muss einmal pro Prozess aufgerufen werden, bevor andere DISM-API-Funktionen aufgerufen werden.
Syntax
HRESULT WINAPI DismInitialize(
_In_ DismLogLevel LogLevel,
_In_opt_ PCWSTR LogFilePath,
_In_opt_ PCWSTR ScratchDirectory
);
Parameter
LogLevel [in]
Ein DismLogLevel-Enumerationswert, z. B . DismLogErrorsWarnings.
LogFilePath [in, optional]
Optional. Ein relativer oder absoluter Pfad zu einer Protokolldatei. Alle generierten Nachrichten werden in diesem Pfad protokolliert. Wenn NULL, wird der Standardprotokollpfad %windir%\Logs\DISM\dism.log verwendet.
ScratchDirectory [in, optional]
Optional. Ein relativer oder absoluter Pfad zu einem Scratch-Verzeichnis. Die DISM-API verwendet dieses Verzeichnis für interne Vorgänge. Wenn NULL, wird das standardmäßige temporäre Verzeichnis \Windows\%Temp% verwendet.
Rückgabewert
Gibt bei Erfolg S_OK zurück.
Gibt DISMAPI_E_DISMAPI_ALREADY_INITIALIZED zurück, wenn DismInitialize bereits vom Prozess ohne einen übereinstimmenden Aufruf von DismShutdown aufgerufen wurde.
Gibt HRESULT_FROM_WIN32(ERROR_ELEVATION_REQUIRED) zurück, wenn der Prozess nicht mit erhöhten Rechten versehen ist.
Bemerkungen
Der Clientcode muss DismInitialize einmal pro Prozess aufrufen. Die DISM-API wird gleichzeitige Aufrufe an DismShutdown serialisieren. Der erste Aufruf wird erfolgreich sein und die anderen Anrufe werden fehlschlagen. Weitere Informationen finden Sie unter Verwenden der DISM-API.
Beispiel
HRESULT hr = S_OK;
DismLogLevel Level = DismLogErrorsWarningsInfo;
hr = DismInitialize(Level, NULL, NULL);
Anforderungen
| Anforderung | Beschreibung |
|---|---|
| Unterstützte Hostplattformen: | Die DISM-API kann auf jedem Betriebssystem verwendet werden, das vom Windows Assessment and Bereitstellung Kit (Windows ADK) unterstützt wird. Weitere Informationen finden Sie in der technischen Referenz zum Windows ADK. |
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Header | DismAPI.h |
| Bibliothek | DismAPI.lib |
| DLL | DismAPI.dll |