Função AlignReservedLog (clfsw32.h)

Calcula o tamanho da reserva alinhada ao setor para um conjunto de registros reservados. Esse valor é então passado para AllocReservedLog para reservar um bloco de espaço de log para um conjunto de registros.

Sintaxe

CLFSUSER_API BOOL AlignReservedLog(
  [in, out] PVOID       pvMarshal,
  [in]      ULONG       cReservedRecords,
  [in]      LONGLONG [] rgcbReservation,
  [out]     PLONGLONG   pcbAlignReservation
);

Parâmetros

[in, out] pvMarshal

Um ponteiro para o contexto de marshaling opaco alocado chamando a função CreateLogMarshallingArea .

[in] cReservedRecords

O número de registros reservados associados ao ajuste de reserva.

[in] rgcbReservation

Uma matriz de alocações de espaço a ser reservada no log associado ao contexto de marshaling atual, em bytes.

O número de alocações corresponde ao número de registros especificados por cReservedRecords . Cada alocação deve ser maior que zero (0) ou a função falha com ERROR_INVALID_PARAMETER.

[out] pcbAlignReservation

Um ponteiro para uma variável na qual a função retorna o número de espaço de bytes alinhado ao setor a ser reservado no log, depois de receber o número de registros especificados por cRecords e o tamanho das reservas especificadas na matriz rgcbReservation .

O valor retornado em *pcbAlignReservation é usado como entrada para AllocReservedLog. Se AllocReservedLog for bem-sucedido, esse valor será sempre maior que zero (0). Se AllocReservedLog falhar, o valor será zero (0).

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será 0 (zero). Para obter informações de erro estendidas, chame GetLastError. A lista a seguir identifica os possíveis códigos de erro:

Requisitos

Confira também

AllocReservedLog

Funções comuns do sistema de arquivos de log