Função FsRtlGetNextExtraCreateParameter (ntifs.h)
A rotina FsRtlGetNextExtraCreateParameter retorna um ponteiro para a próxima (ou primeira) estrutura de contexto de parâmetro de criação extra (ECP) em uma determinada lista ECP.
Sintaxe
NTSTATUS FsRtlGetNextExtraCreateParameter(
[in] PECP_LIST EcpList,
[in, optional] PVOID CurrentEcpContext,
[out, optional] LPGUID NextEcpType,
[out] PVOID *NextEcpContext,
[out, optional] ULONG *NextEcpContextSize
);
Parâmetros
[in] EcpList
Ponteiro para a lista ECP a ser examinada.
[in, optional] CurrentEcpContext
Ponteiro opcional para uma estrutura de contexto ECP na lista ECP fornecida. Se presente, FsRtlGetNextExtraCreateParameter retornará um ponteiro para o ECP após a estrutura de contexto ECP CurrentEcpContext . Se CurrentEcpContext for NULL, FsRtlGetNextExtraCreateParameter retornará a primeira estrutura de contexto ECP na lista.
[out, optional] NextEcpType
Parâmetro opcional que recebe um ponteiro para o GUID da estrutura de contexto ECP retornada.
[out] NextEcpContext
Parâmetro opcional que recebe um ponteiro para a estrutura de contexto ECP retornada.
[out, optional] NextEcpContextSize
Parâmetro opcional que recebe o tamanho, em bytes, da estrutura de contexto ECP retornada.
Retornar valor
FsRtlGetNextExtraCreateParameter retorna um dos seguintes valores NTSTATUS:
Código de retorno | Descrição |
---|---|
|
FsRtlGetNextExtraCreateParameter encontrou uma estrutura de contexto ECP na lista ECP EcpList . |
|
A lista ECP EcpList está vazia ou CurrentEcpContext é o último ECP na lista (ou seja, não há nenhum próximo elemento de lista ECP). Além disso, NextEcpContext é definido como NULL e NextEcpContextSize é definido como zero. |
|
O parâmetro EcpList é NULL. |
Comentários
A rotinaFsRtlGetNextExtraCreateParameter processa uma lista ECP de maneira não circular. Ou seja, se a estrutura de contexto ECP apontada pelo parâmetro CurrentEcpContext for o último elemento na lista ECP, não haverá nenhum ECP "próximo" na lista e a rotina retornará STATUS_NOT_FOUND.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | A rotina FsRtlGetNextExtraCreateParameter está disponível a partir do Windows Vista. |
Plataforma de Destino | Universal |
Cabeçalho | ntifs.h (inclua Ntifs.h) |
Biblioteca | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |
Confira também
FltAllocateExtraCreateParameter
FltAllocateExtraCreateParameterFromLookasideList
FltAllocateExtraCreateParameterList