Compartilhar via

Função RtlQueryPackageIdentityEx (ntifs.h)

  • Artigo

RtlQueryPackageIdentityEx retorna o nome do pacote completo associado. Opcionalmente, ele também pode retornar o nome do aplicativo relativo do pacote e se um aplicativo é considerado empacotado.

Sintaxe

NTSYSAPI NTSTATUS RtlQueryPackageIdentityEx(
  PVOID    TokenObject,
  PWSTR    PackageFullName,
  PSIZE_T  PackageSize,
  PWSTR    AppId,
  PSIZE_T  AppIdSize,
  LPGUID   DynamicId,
  PULONG64 Flags
);

Parâmetros

TokenObject

Manipule para um objeto de token (modo de usuário) que foi aberto com acesso TOKEN_QUERY ou para um objeto de token bruto (modo kernel).

PackageFullName

Ponteiro para um buffer de caractere largo que receberá a chave de pacote exclusiva. O buffer será encerrado nulo após o êxito.

PackageSize

Ponteiro para o valor que define o tamanho do buffer para o qual PackageFullName aponta. Na saída, ele conterá o tamanho gravado, incluindo a terminação nula.

AppId

Ponteiro para um buffer de caractere largo que pode receber o identificador de aplicativo relativo do pacote. AppId é opcional e pode ser NULL.

AppIdSize

Ponteiro para o valor que define o tamanho do buffer ao qual AppId aponta. Na saída, ele conterá o tamanho gravado, incluindo a terminação nula. Se AppId não estiver NULL, AppIdSize deverá apontar para um valor válido; caso contrário, AppIdSize deve ser definido como NULL.

DynamicId

Ponteiro para um valor que recebe uma ID dinâmica para o aplicativo. DynamicId é opcional e pode ser NULL.

Flags

Ponteiro para um valor que recebe uma máscara de bits de valores para o atributo de pacote.

Valor de retorno

RtlQueryPackageIdentityEx retorna STATUS_SUCCESS após a conclusão bem-sucedida; caso contrário, ele retorna um código como um dos seguintes.

Código de erro Significado
STATUS_INVALID_PARAMETER Um parâmetro contém um valor inválido; por exemplo, um valor de tamanho não foi fornecido para um buffer não NULL. Este é um código de erro.
STATUS_NOT_FOUND Uma identidade de pacote não existe.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 8.1
cabeçalho ntifs.h