RtlQueryPackageIdentity 함수(ntifs.h)

  • 아티클

RtlQueryPackageIdentity 는 연결된 전체 패키지 이름을 반환합니다. 필요에 따라 패키지 상대 애플리케이션 이름 및 애플리케이션이 패키지된 것으로 간주되는지 여부를 반환할 수도 있습니다. RtlQueryPackageIdentityEx도 참조하세요.

구문

NTSYSAPI NTSTATUS RtlQueryPackageIdentity(
  PVOID    TokenObject,
  PWSTR    PackageFullName,
  PSIZE_T  PackageSize,
  PWSTR    AppId,
  PSIZE_T  AppIdSize,
  PBOOLEAN Packaged
);

매개 변수

TokenObject

TOKEN_QUERY 액세스로 연 토큰 개체(사용자 모드) 또는 원시 토큰 개체(커널 모드)에 대한 핸들입니다.

PackageFullName

고유한 패키지 키를 받을 와이드 문자 버퍼에 대한 포인터입니다. 버퍼는 성공하면 null이 종료됩니다.

PackageSize

PackageFullName에서 가리키는 버퍼의 크기를 정의하는 값에 대한 포인터입니다. 출력에 종료 null을 포함하여 작성된 크기가 포함됩니다.

AppId

패키지 상대 애플리케이션 식별자를 받을 수 있는 와이드 문자 버퍼에 대한 포인터입니다. AppId 는 선택 사항이며 NULL일 수 있습니다.

AppIdSize

AppId가 가리키는 버퍼의 크기를 정의하는 값에 대한 포인터입니다. 출력에 종료 null을 포함하여 작성된 크기가 포함됩니다. AppId가 NULL이 아닌 경우 AppIdSize는 유효한 값을 가리킵니다. 그렇지 않으면 AppIdSize가 NULL로 설정되어야 합니다.

Packaged

애플리케이션이 패키지되었는지 여부를 나타내는 BOOLEAN 플래그를 수신하는 값에 대한 포인터입니다. 패키지는 선택 사항이며 NULL일 수 있습니다.

반환 값

RtlQueryPackageIdentity 는 성공적으로 완료되면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 다음 중 하나와 같은 코드를 반환합니다.

오류 코드 의미
STATUS_INVALID_PARAMETER 매개 변수에 잘못된 값이 포함되어 있습니다. 예를 들어 NULL이 아닌 버퍼에 대해 크기 값이 제공되지 않았습니다. 오류 코드입니다.
STATUS_NOT_FOUND 패키지 ID가 없습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8
머리글 ntifs.h

추가 정보

RtlQueryPackageIdentityEx