Función DismInitialize
[Parte de la información hace referencia a la versión preliminar del producto, el cual puede sufrir importantes modificaciones antes de que se publique la versión comercial. Microsoft no ofrece ninguna garantía, expresa o implícita, con respecto a la información que se ofrece aquí].
Inicializa la API de DISM. Se debe llamar a DismInitialize una vez por proceso, antes de llamar a cualquier otra función de LA API de DISM.
Sintaxis
HRESULT WINAPI DismInitialize(
_In_ DismLogLevel LogLevel,
_In_opt_ PCWSTR LogFilePath,
_In_opt_ PCWSTR ScratchDirectory
);
Parámetros
LogLevel [in]
Valor de enumeración DismLogLevel , como DismLogErrorsWarnings.
LogFilePath [in, opcional]
Opcional. Ruta de acceso relativa o absoluta a un archivo de registro. Todos los mensajes generados se registrarán en esta ruta de acceso. Si es NULL, se usará la ruta de acceso del registro predeterminada, %windir%\Logs\DISM\dism.log.
ScratchDirectory [in, opcional]
Opcional. Ruta de acceso relativa o absoluta a un directorio temporal. LA API DISM usará este directorio para las operaciones internas. Si es NULL, se usará el directorio temporal predeterminado \Windows\%Temp%.
Valor devuelto
Devuelve S_OK si se realiza correctamente.
Devuelve DISMAPI_E_DISMAPI_ALREADY_INITIALIZED si el proceso ya ha llamado a DismInitialize sin una llamada coincidente a DismShutdown.
Devuelve HRESULT_FROM_WIN32(ERROR_ELEVATION_REQUIRED) si el proceso no es elevado.
Comentarios
El código de cliente debe llamar a DismInitialize una vez por proceso. LA API de DISM serializará las llamadas simultáneas a DismInitialize. La primera llamada se realizará correctamente y se producirá un error en las demás. Para obtener más información, consulte Uso de la API dism.
Ejemplo
HRESULT hr = S_OK;
DismLogLevel Level = DismLogErrorsWarningsInfo;
hr = DismInitialize(Level, NULL, NULL);
Requisitos
| Requisito | Descripción |
|---|---|
| Plataformas host admitidas: | El API de DISM puede usarse en cualquier sistema operativo que Windows Assessment and Deployment Kit (Windows ADK) soporte. Para obtener más información, consulta la Referencia técnica de Windows ADK. |
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Encabezado | DismAPI.h |
| Biblioteca | DismAPI.lib |
| Archivo DLL | DismAPI.dll |