Função DismGetFeatureInfo
Obtém informações detalhadas do para o recurso especificado.
Sintaxe
HRESULT WINAPI DismGetFeatureInfo(
_In_ DismSession Session,
_In_ PCWSTR FeatureName,
_In_opt_ PCWSTR Identifier,
_In_opt_ DismPackageIdentifier PackageIdentifier,
_Out_ DismFeatureInfo **FeatureInfo
);
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 sobre o qual você deseja obter mais informações.
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. |
FeatureInfo [out]
Um ponteiro para o endereço de uma matriz de estruturas DismFeatureInfo .
Retornar valor
Retorna S_OK se há êxito.
Comentários
Você pode usar essa função para obter as propriedades personalizadas de um recurso. Se o recurso tiver propriedades personalizadas, elas serão armazenadas no campo CustomProperty como uma matriz. Nem todos os recursos têm propriedades personalizadas.
Exemplo
HRESULT hr = S_OK;
DismFeatureInfo FeatureInfo;
hr = DismGetFeatureInfo(Session, "Xps-Foundation-Xps-Viewer", NULL, NULL, &FeatureInfo);
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 |