Compartilhar via


Rotina MRxQuerySdInfo

A rotinaMRxQuerySdInfo é chamada pelo RDBSS para solicitar que um minidiretório de rede consulte informações de descritor de segurança em um objeto do sistema de arquivos.

Sintaxe

PMRX_CALLDOWN MRxQuerySdInfo;

NTSTATUS MRxQuerySdInfo(
  _Inout_ PRX_CONTEXT RxContext
)
{ ... }

Parâmetros

RxContext [in, out]
Um ponteiro para a estrutura RX_CONTEXT. Esse parâmetro contém o IRP que está solicitando a operação.

Retornar valor

MRxQuerySdInfo retorna STATUS_SUCCESS com êxito ou um valor NTSTATUS apropriado, como um dos seguintes:

Código de retorno Descrição
STATUS_ACCESS_DENIED

O chamador não tinha a segurança adequada para esta operação.

STATUS_BUFFER_OVERFLOW

O buffer para receber as informações do descritor de segurança era muito pequeno.

Esse valor retornado deve ser considerado êxito e o máximo de dados válidos possível deve ser retornado no membro Info.Buffer da estrutura RX_CONTEXT apontada pelo parâmetro RxContext .

STATUS_BUFFER_TOO_SMALL

O buffer é muito pequeno para receber os dados solicitados.

Se esse valor for retornado, o membro InformationToReturn da estrutura RX_CONTEXT apontada pelo parâmetro RxContext deverá ser definido como o tamanho mínimo do buffer esperado para que a chamada seja bem-sucedida.

STATUS_CONNECTION_DISCONNECTED

A conexão foi desconectada.

STATUS_INSUFFICIENT_RESOURCES

Não havia recursos suficientes para concluir a consulta.

STATUS_INVALID_PARAMETER

Um parâmetro inválido foi especificado.

STATUS_NETWORK_ACCESS_DENIED

O acesso à rede foi negado.

STATUS_NOT_IMPLEMENTED

Um recurso solicitado, como informações em um arquivo de página remota, não é implementado.

STATUS_NOT_SUPPORTED

Não há suporte para informações de descritor de segurança no compartilhamento remoto.

STATUS_OBJECT_PATH_NOT_FOUND

O caminho do objeto não foi encontrado. Esse erro poderá ser retornado se informações sobre um objeto de fluxo NTFS forem solicitadas e o sistema de arquivos remoto não oferecer suporte a fluxos.

STATUS_REPARSE

Uma nova análise é necessária para lidar com um link simbólico.

Comentários

O RDBSS emite uma chamada para MRxQuerySdInfo em resposta ao recebimento de uma solicitação de IRP_MJ_QUERY_SECURITY .

Antes de chamar MRxQuerySdInfo, o RDBSS modifica os seguintes membros na estrutura RX_CONTEXT apontada pelo parâmetro RxContext :

O membro QuerySecurity.SecurityInformation está definido como IrpSp-Parameters.QuerySecurity.SecurityInformation>.

O membro Info.Buffer é definido como buffer de usuário do pacote de solicitação de E/S. Esse buffer já foi bloqueado pelo RDBSS, se necessário.

O membro Info.LengthRemaining está definido como IrpSp-Parameters.QuerySecurity.Length>.

Com êxito, o minidiretório de rede deve definir o membro InformationToReturn da estrutura RX_CONTEXT para o comprimento das informações de segurança retornadas. Se a chamada para MRxQuerySdInfo tiver sido bem-sucedida, o RDBSS definirá o membro IoStatus.Information do IRP como o membro InformationToReturn do RX_CONTEXT.

Requisitos

Plataforma de destino

Área de Trabalho

parâmetro

Mrx.h (inclua Mrx.h)

Confira também

MRxIsValidDirectory

MRxQueryDirectory

MRxQueryEaInfo

MRxQueryFileInfo

MRxQueryQuotaInfo

MRxQueryVolumeInfo

MRxSetEaInfo

MRxSetFileInfo

MRxSetFileInfoAtCleanup

MRxSetQuotaInfo

MRxSetSdInfo

MRxSetVolumeInfo