Função GetPackagesByPackageFamily (appmodel.h)
Obtém os pacotes com o nome de família especificado para o usuário atual.
Sintaxe
LONG GetPackagesByPackageFamily(
[in] PCWSTR packageFamilyName,
[in, out] UINT32 *count,
[out, optional] PWSTR *packageFullNames,
[in, out] UINT32 *bufferLength,
[out, optional] WCHAR *buffer
);
Parâmetros
[in] packageFamilyName
Tipo: PCWSTR
O nome da família do pacote.
[in, out] count
Tipo: UINT32*
Um ponteiro para uma variável que contém o número de nomes completos do pacote.
Primeiro, você passa NULL para packageFullNames para obter o número de nomes completos do pacote. Você usa esse número para alocar espaço de memória para packageFullNames. Em seguida, você passa o endereço desse número para preencher packageFullNames.
[out, optional] packageFullNames
Tipo: PWSTR*
Um ponteiro para as cadeias de caracteres de nomes completos do pacote.
[in, out] bufferLength
Tipo: UINT32*
Um ponteiro para uma variável que contém o número de caracteres na cadeia de caracteres de nomes completos do pacote.
Primeiro, você passa NULL para o buffer para obter o número de caracteres. Você usa esse número para alocar espaço de memória para buffer. Em seguida, você passa o endereço desse número para preencher o buffer.
[out, optional] buffer
Tipo: WCHAR*
A cadeia de caracteres para todos os nomes completos do pacote.
Retornar valor
Tipo: LONG
Se a função for bem-sucedida , ela retornará ERROR_SUCCESS. Caso contrário, a função retornará um código de erro. Os códigos de erro possíveis incluem o seguinte.
Código de retorno | Descrição |
---|---|
|
Um ou mais buffers não são grandes o suficiente para manter os dados. O tamanho necessário é especificado por contagem ou buffer. |
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | appmodel.h |
Biblioteca | Kernel32.lib |
DLL | Kernel32.dll |