FSCTL_SET_REPARSE_POINT código de controle

Artigo
03/14/2023

O código de controle FSCTL_SET_REPARSE_POINT define um ponto de nova análise em um arquivo ou diretório.

Para executar essa operação, chame ZwFsControlFile com os parâmetros a seguir.

Os minifiltros devem usar FltTagFile em vez de FSCTL_SET_REPARSE_POINT para definir um ponto de nova análise.

Para obter mais informações sobre pontos de nova análise e o código de controle FSCTL_SET_REPARSE_POINT, consulte a documentação do SDK do Microsoft Windows.

Parâmetros

FileHandle [in]: identificador de arquivo para o arquivo ou diretório no qual definir um ponto de nova análise. Esse parâmetro é necessário e não pode ser NULL.
FsControlCode [in]: código de controle para a operação. Use FSCTL_SET_REPARSE_POINT para esta operação.
InputBuffer [in]: ponteiro para uma estrutura de REPARSE_GUID_DATA_BUFFER ou REPARSE_DATA_BUFFER alocada pelo chamador que contém os dados do ponto de nova análise. Se um ponto de nova análise existente estiver sendo modificado, a marca especificada no membro ReparseTag dessa estrutura deverá corresponder à marca do ponto de nova análise a ser modificado. Além disso, se o ponto de nova análise for um ponto de nova análise de terceiros (não Microsoft), o GUID especificado no membro ReparseGuid da estrutura será um REPARSE_GUID_DATA_BUFFER estrutura deverá corresponder ao GUID do ponto de nova análise a ser modificado.
InputBufferLength [in]: Tamanho, em bytes, do buffer apontado pelo parâmetro InputBuffer . Para uma estrutura REPARSE_GUID_DATA_BUFFER, esse valor deve ser pelo menos REPARSE_GUID_DATA_BUFFER_HEADER_SIZE, além do tamanho dos dados definidos pelo usuário e deve ser menor ou igual a MAXIMUM_REPARSE_DATA_BUFFER_SIZE. Para uma estrutura REPARSE_DATA_BUFFER, esse valor deve ser pelo menos REPARSE_DATA_BUFFER_HEADER_SIZE, além do tamanho dos dados definidos pelo usuário e deve ser menor ou igual a MAXIMUM_REPARSE_DATA_BUFFER_SIZE.
OutputBuffer [out]: não usado com esta operação; definido como NULL.
OutputBufferLength [out]: não usado com esta operação; definido como zero.

Bloco de status

ZwFsControlFile retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes:

Código	Significado
STATUS_DIRECTORY_NOT_EMPTY	Um ponto de nova análise não pode ser definido em um diretório não vazio. Este é um código de erro.
STATUS_EAS_NOT_SUPPORTED	Um ponto de nova análise não poderá ser definido em um arquivo se essa solicitação estiver em uma transação. Este é um código de erro.
STATUS_IO_REPARSE_DATA_INVALID	Um dos valores de parâmetro especificados era inválido. Este é um código de erro.
STATUS_IO_REPARSE_TAG_MISMATCH	A marca de nova análise especificada pelo chamador não correspondeu à marca do ponto de nova análise a ser modificado. Este é um código de erro.
STATUS_NOT_A_REPARSE_POINT	O arquivo ou diretório não é um ponto de nova análise. Este é um código de erro.
STATUS_REPARSE_ATTRIBUTE_CONFLICT	O ponto de nova análise é um ponto de nova análise de terceiros e o GUID de nova análise especificado pelo chamador não correspondeu ao GUID do ponto de nova análise a ser modificado. Este é um código de erro.