Función DismGetFeatureInfo
Obtiene información detallada de para la característica especificada.
Sintaxis
HRESULT WINAPI DismGetFeatureInfo(
_In_ DismSession Session,
_In_ PCWSTR FeatureName,
_In_opt_ PCWSTR Identifier,
_In_opt_ DismPackageIdentifier PackageIdentifier,
_Out_ DismFeatureInfo **FeatureInfo
);
Parámetros
Sesión [in]
Valor de DismSession válido. DismSession debe estar asociado a una imagen. Puede asociar una sesión a una imagen mediante DismOpenSession.
FeatureName [in]
Nombre de la característica sobre la que desea obtener más información.
Identificador [in, opcional]
Opcional. Una ruta de acceso absoluta a un archivo .cab o el nombre del paquete, según el valor del parámetro PackageIdentifier.
PackageIdentifier [in, opcional]
Opcional. Un valor de enumeración de DismPackageIdentifier válido.
| Valor | Descripción |
|---|---|
| PackageName | Use este valor cuando desee especificar un paquete mediante el nombre. |
| PackagePath | Use este valor cuando desee especificar un paquete mediante una ruta de acceso absoluta a un archivo .cab. |
| PackageNone | No es un valor válido para esta función. |
FeatureInfo [out]
Puntero a la dirección de una matriz de estructuras DismFeatureInfo .
Valor devuelto
Si se descarga correctamente, devuelve S_OK .
Comentarios
Puede usar esta función para obtener las propiedades personalizadas de una característica. Si la característica tiene propiedades personalizadas, se almacenarán en el campo CustomProperty como una matriz. No todas las características tienen propiedades personalizadas.
Ejemplo
HRESULT hr = S_OK;
DismFeatureInfo FeatureInfo;
hr = DismGetFeatureInfo(Session, "Xps-Foundation-Xps-Viewer", NULL, NULL, &FeatureInfo);
Requisitos
| Requisito | Descripción |
|---|---|
| Plataformas host soportadas | La API de DISM puede usarse en cualquier sistema operativo que el Windows Assessment and Deployment Kit (Windows ADK) admita. Para obtener más información, consulta la Referencia técnica de Windows ADK. |
| Plataformas de imágenes soportadas | Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, Entorno de Preinstalación de Windows (Windows PE) 4.0, Windows 8.1, Windows Server 2012 R2, Windows 10 y Windows Server 2016 |
| 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 |