Função DismGetFeatureParent
Obtém os recursos pai de um recurso especificado.
Sintaxe
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
Session [in]
Uma DismSession válida. A DismSession deve ser associada a uma imagem. Você pode associar uma sessão a uma imagem usando DismOpenSession.
FeatureName [in]
O nome do recurso do qual você deseja encontrar o pai.
Identificador [in, opcional]
Opcional. Um caminho absoluto para um arquivo .cab ou o nome do pacote, dependendo do valor do parâmetro PackageIdentifier.
PackageIdentifier [in, opcional]
Opcional. Um valor de enumeração DismPackageIdentifier válido.
| Valor | Descrição |
|---|---|
| PackageName | Use esse valor quando quiser especificar um pacote usando o nome dele. |
| PackagePath | Use esse valor quando quiser especificar um pacote usando um caminho absoluto para um arquivo de .cab. |
| PackageNone | Não é um valor válido para esta função. |
Recurso [out]
Um ponteiro para o endereço de uma matriz de estruturas DismFeature .
Count [out]
O número de estruturas DismFeature que foram retornadas.
Retornar valor
Retornará S_OK se houver êxito.
Comentários
Para que um recurso seja habilitado, um ou mais de seus recursos pai devem ser habilitados. Você pode usar essa função para enumerar os recursos pai e determinar qual pai precisa ser habilitado.
Exemplo
HRESULT hr = S_OK;
DismFeature* Feature;
UINT FeatureCount;
hr = DismGetFeatureParent(Session,"Xps-Foundation-Xps-Viewer", NULL, NULL, &Feature, &FeatureCount);
Requisitos
| Requisito | Descrição |
|---|---|
| Plataformas de host com suporte | A API DISM pode ser usada em qualquer sistema operacional compatível com o Windows ADK (Kit de Avaliação e Implantação). Para obter mais informações, confira a Referência técnica do Windows ADK. |
| Plataformas de imagem com suporte | Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, Windows PE (Ambiente de Pré-Instalação do Windows) 4.0, Windows 8.1, Windows Server 2012 R2, Windows 10, Windows Server 2016 |
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Cabeçalho | DismAPI.h |
| Biblioteca | DismAPI.lib |
| DLL | DismAPI.dll |