Función DismGetFeatureParent
Obtiene las características primarias de una característica especificada.
Sintaxis
HRESULT WINAPI DismGetFeatureParent(
_In_ DismSession Session,
_In_ PCWSTR FeatureName,
_In_opt_ PCWSTR Identifier,
_In_opt_ DismPackageIdentifier PackageIdentifier,
_Out_ DismFeature **Feature,
_Out_ UINT *Count
);
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 de la que desea encontrar el elemento primario.
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, optional]
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. |
Característica [salida]
Puntero a la dirección de una matriz de estructuras DismFeature .
Recuento [out]
Número de estructuras DismFeature que se devolvieron.
Valor devuelto
Devuelve S_OK si se realiza correctamente.
Comentarios
Para que se habilite una característica, se debe habilitar una o varias de sus características primarias. Puede usar esta función para enumerar las características primarias y determinar qué elemento primario debe habilitarse.
Ejemplo
HRESULT hr = S_OK;
DismFeature* Feature;
UINT FeatureCount;
hr = DismGetFeatureParent(Session,"Xps-Foundation-Xps-Viewer", NULL, NULL, &Feature, &FeatureCount);
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 |