Compartilhar via


Método IXpsSignatureBlockCollection::RemoveAt (xpsdigitalsignature.h)

Remove e libera um ponteiro de interface IXpsSignatureBlock de um local especificado na coleção.

Sintaxe

HRESULT RemoveAt(
  UINT32 index
);

Parâmetros

index

O índice baseado em zero na coleção da qual um ponteiro de interface IXpsSignatureBlock deve ser removido e liberado.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK; caso contrário, ele retornará um código de erro HRESULT .

Comentários

No local especificado pelo índice, esse método libera a interface referenciada por um ponteiro IXpsSignatureBlock . Em seguida, o método compacta a coleção reduzindo em 1 o índice de cada ponteiro subsequente ao índice. Para obter mais informações sobre os métodos de coleção, consulte Trabalhando com interfaces de coleção de OM XPS.

A remoção de um bloco de assinatura da coleção remove do pacote a parte e a relação SignatureDefinitions que correspondem a esse bloco de assinatura. Essa remoção interrompe as assinaturas existentes. Além disso, o nome da parte SignatureDefinitions é removido da lista de partes XPS necessárias, o que impede que novas assinaturas incluam o bloco de assinatura removido.

Uma interface que foi removida de uma coleção não é mais válida. Se um aplicativo reter um ponteiro para a interface e tentar chamar um de seus métodos, o método retornará XPS_E_OBJECT_DETACHED.

Requisitos

   
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho xpsdigitalsignature.h

Confira também

IXpsSignatureBlock

IXpsSignatureBlockCollection

Trabalhando com interfaces de coleção de OM XPS

Especificação de Papel XML