Função NtQuerySection

Fornece a capacidade de determinar o endereço base, o tamanho, o acesso concedido e a alocação de um objeto de seção aberto.

Sintaxe

NTSTATUS NTAPI NtQuerySection (
    _In_ HANDLE SectionHandle,
    _In_ SECTION_INFORMATION_CLASS SectionInformationClass,
    _Out_writes_bytes_(SectionInformationLength) PVOID SectionInformation,
    _In_ SIZE_T SectionInformationLength,
    _Out_opt_ PSIZE_T ReturnLength
    )

Parâmetros

SectionHandle [in]

Um identificador aberto para um objeto de seção.

SectionInformationClass [in]

A classe de informações da seção sobre a qual recuperar informações.

SectionInformation [out]

Um ponteiro para um buffer que recebe as informações especificadas. O formato e o conteúdo do buffer dependem da classe de seção especificada.

SectionInformationLength [in]

Especifica o comprimento em bytes do buffer de informações da seção.

ReturnLength [out]

Um ponteiro opcional que, se especificado, recebe o número de bytes colocados no buffer de informações da seção.

Valor retornado

Um código NTSTATUS. Para obter mais informações, consulte Usando valores NTSTATUS.

Comentários

Essa função não tem biblioteca de importação ou arquivo de cabeçalho associado; você deve chamá-lo usando as funções LoadLibrary e GetProcAddress . A API é exportada de ntdll.dll.

O tipo do parâmetro SectionInformation é PSECTION_BASIC_INFORMATION

typedef struct _SECTIONBASICINFO {
    PVOID BaseAddress;
    ULONG AllocationAttributes;
    LARGE_INTEGER MaximumSize;
} SECTION_BASIC_INFORMATION, *PSECTION_BASIC_INFORMATION;

PVOID BaseAddress

O endereço virtual base da seção se a seção for baseada.

Alocação do ULONGTributes

Os sinalizadores de atributos de alocação.

Sinalizador Valor Descrição
SEC_BASED 0x200000 A seção é uma seção baseada.
SEC_FILE 0x800000 A seção é apoiada por um arquivo de dados.
SEC_RESERVE 0x4000000 Todas as páginas da seção foram inicialmente definidas como o estado reservado.
SEC_COMMIT 0x8000000 Todas as páginas da seção foram inicialmente definidas como o estado confirmado.
SEC_IMAGE 0x1000000 A seção foi mapeada como um arquivo de imagem executável.

LARGE_INTEGER MaximumSize

O tamanho máximo da seção em bytes.

Requisitos

Requisito Valor
DLL ntdll.dll