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 a um objeto de token bruto (modo kernel).

PackageFullName

Ponteiro para um buffer de caracteres largos que receberá a chave de pacote exclusiva. O buffer será encerrado em 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 o nulo de terminação.

AppId

Ponteiro para um buffer de caracteres largos 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 para o qual AppId aponta. Na saída, ele conterá o tamanho gravado, incluindo o nulo de terminação. Se AppId não for NULL, AppIdSize deverá apontar para um valor válido; caso contrário , AppIdSize deve definir 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.

Retornar valor

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

Código do 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
Cliente mínimo com suporte Windows 8.1
Cabeçalho ntifs.h